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1. 关于 本 文 


本 文档 是 由 Go 语言 中 文 小 组 根据 golang.org 的 文档 翻译 ， 最 新 的 翻译 文档 可 以 从 
http://code.google.com/p/golang-china/ 获 取 。 
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本 文档 依照 创作 公共 约定 (署名 - 非 商 业 性 使 用 -相同 方式 共享 )3.0 发 布 。 


Go 语言 是 由 Google 开 发 的 一 个 开源 项 目 ， 目 的 之 一 为 了 提高 开发 人 员 的 编程 交 

率 。 Go 语言 语法 灵活 、 简 洁 、 清 晰 、 高 效 。 它 对 的 并 发 特性 可 以 方便 地 用 于 多 核 
处 理 器 和 网 络 开 发 ， 同 时 灵活 新 颖 的 类 型 系统 可 以 方便 地 编写 模块 化 的 系统 。go 可 
以 快速 编译 ， 同时 具有 垃圾 内 存 自 动 回收 功能 ， 并 且 还 支持 运行 时 反射 。Go 是 一 
个 高 效 、 静 态 类 型 ， 但 是 又 具有 解释 语言 的 动态 类 型 特征 的 系统 级 语法 。 


CEN, 


m 
\ o> 





下 面 是 用 go 编写 的 "Hello, world" 程 序 : 


package main 
import "fmt" 


func main() { 
fmt.Printlin("Hello, %3") 
} 


3.1. 简介 


Go 是 一 个 开源 项 目 ， 采 用 BSD 授 权 协 议 。 该 文档 介绍 如 何 获取 Go 源 代 码 ， 如 何 编 
译 ， 以 及 如 何 运行 Go 程序 。 


目前 有 两 种 方式 使 用 Go 语言 。 这 里 主要 讲述 如 何 使 用 Go 专用 的 gc 系列 工具 (6g, 
8g 等 ) 。 另 一 个 可 选 的 编译 器 是 基于 gcc 后 端的 gccgo 编 译 器 。 关 于 gccgo 的 细节 
清 参 考 安 装 并 使 用 gccgo 编 译 器 。 


Go 编译 器 可 以 支持 三 种 指 合集 。 不 同体 系 结构 生成 的 代码 质量 有 一 些 差 别 : 
amd64 (a.k.a. x86-64); 6g,6l,6c,6a 


最 成 熟 的 实现 ， 编 译 器 在 寄存 器 级 别 优化 ， 可 以 生成 高 质量 的 目标 代码 (有 时 候 
gccgo 可 能 更 优 ) 。 


386 (a.k.a. x86 or x86-32); 8g,81,8c,8a 
amd64 平 台 的 的 完整 移植 。 
arm (a.k.a. ARM); 59,5l,5c,5a 


在 完善 中 。 目 前 只 支持 生成 Linux 的 二 进 制 文件 ， 浮 点 支持 比较 项 乏 ， 并 且 生 成 目标 
代码 时 还 存在 bug。 还 没有 完全 通过 测试 集 ， 也 没有 任何 优化 。 


除了 系统 级 的 接口 ，go 需 要 的 运行 时 环境 对 各 个 平台 都 是 一 致 的 。 包 含 mark-and- 
sweep 垃圾 内 存 自动 回收 〈 更 高 效 的 算法 实现 正在 开发 中 ) ， Bea SRR. B 
能 堆栈 以 及 goroutine 等 。 


目前 支持 以 下 系统 : FreeBSD, Linux, Native Client 和 OS X (a.k.a. Darwin). 
Microsoft Windows 目前 正在 移植 中 ， 功能 还 不 完整 。 关 于 各 个 系统 平台 的 详细 说 
明 ， 可 以 参考 后 面 的 [环境 变量 ] 一 节 。 


3.2. 安装 C 语 言 工具 


Go 的 工具 链 采 用 C 语 言 编写 ， 构 建 需要 安装 以 下 开发 工具 : 


GCC， 
CHEER, 
Bison, 

make, 

awk, 和 

ed 《编辑 器 ) . 


对 于 OS X 系统 ， 以 上 工具 是 Xcode 的 一 部 分 。 


对 于 Ubuntu/Debian 系统 ， 运 行 安 装 命令 : 
sudo apt-get install bison ed gawk gcc libc6-dev make 


3.3. 安装 Mercurial 


在 进行 后 面 的 操作 之 前 需要 安装 Mercurial 版 本 管理 系统 (可 以 输出 hg 名 字 检 测 是 
安装 ) 。 安 装 输 入 以 下 命令 : 


sudo easy_install mercurial 


对 于 Ubuntu/Debian 系统 ，easy_install 命令 可 以 用 
apt-get install python-setuptools python-dev build-essential 安装 。 


如 果 上 述 命 合 安 装 失 败 的 话 ， 还 可 以 从 Mercurial Download 下 载 。 


3.4. 获取 代码 


以 下 命令 会 创建 一 个 go 目 录 。 切换 到 相应 目 录 ， 并 且 确 保 当 前 位 置 不 存在 go 目 录 ， 


运行 命令 : 


$ hg clone -r release https://go.googlecode.com/hg/ go 


3.5. 安装 Go 
编译 go 环境 : 


$ cd go/src 
$ ./all.bash 


编译 完成 后 ， 结 尾 会 打印 以 下 信息 。 


--- cd ../test 


Installed Go for linux/amd64 in /home/you/go. 
Installed commands in /home/you/go/bin. 

*** You need to add /home/you/go/bin to your $PATH. 
The compiler is 6g. 


kkk 


其 中 N 对 于 不 同 的 版 本 会 有 差异 ， 表 示 没 有 通过 测试 的 数目 。 


3.6. 编写 程序 
以 file.go 代 码 为 例 ， 用 以 下 命令 编译 : 


$ 6g file.go 


6g 是 针对 amd64 指 邻 的 编译 器 ， 它 的 输出 文件 为 fle.6。 其 中 ‘6’ 表示 文件 是 
amd64 指 使 的 输出 文件 。 如 果 是 386 和 arm 义理 器 ， 后 级 则 为 8 和 5 。 也 就 是 
说 ， 如 果 你 用 的 是 386 义 理 器 ， 那 么 应 该 用 8g 命 令 编 译 ， 输出 的 文件 为 fle.8。 


然后 用 以 下 命令 连接 : 


$ 6l file.6 


一 个 完整 的 例子 : 


$ cat >hello.go <<EOF 
package main 


import "fmt" 


func main() { 
fmt .Printf("hello, world\n") 


} 

EOF 

$ 6g hello.go 
$ 61 hello.6 
$ ./6.out 
hello, world 
$ 


在 连接 的 时 候 ， 没 有 必要 列 出 hello.6 引 用 的 包 (这 里 用 到 了 fmt 包 ) 。 连接 器 (这 
BEC) 会 自动 从 hello.6 文 件 获取 包 的 引用 信息 。 


如 果 是 编译 更 复杂 的 过 程 ， 那 么 可 能 需要 使 用 Makefile。 相 关 的 例子 可 以 参考 
$GOROOT/src/cmd/godoc/Makefile 和 $GOROOT/src/pkg/*/Makefile 。 


3.7. 进一步 学 习 


开始 阅读 Go 语言 人 门 教程 。 

参考 Wiki Codelab 编写 一 个 web 程 序 。 
阅读 Effective Go 

阅读 Go 语言 文档 


3.8. 更 新 go 到 新 版 本 


当 有 新 版 本 发 布 的 时 候 ， 会 在 Go Nuts 邮 件 列表 中 通知 。 可 以 用 以 下 命令 获取 最 新 
的 发 布 版 本 : 


$ cd go/src 

$ hg pull 

$ hg update release 
$ ./all.bash 


3.9. 社区 资源 

{E Freenode IRC 上 ， 可 能 有 很 多 #go-nuts 的 开发 人 员 和 用 户 ， 你 可 以 获取 即时 的 
帮助 。 

还 可 以 访问 Go 语言 的 官方 邮件 列表 Go Nuts, 

Bug 可 以 在 Go issue tracker 提交 。 


对 于 开发 Go 语言 用 户 ， 有 兮 一 个 专门 的 邮件 列表 golang-checkins。 这 里 讨论 的 是 
Go 语言 仓库 代码 的 变更 。 


如 果 是 中 文 用 户 ， 请 访问 : Go 语言 中 文 论坛 。 


3.10. 环境 变量 

Go 编译 器 需要 三 个 必须 的 环境 变量 和 一 个 可 选 的 环境 变量 。 环 境 变 量 在 .bashrc 或 
其 他 配置 文件 中 设置 。 

$GOROOT 

Go 安装 包 的 根 上 目录。 通常 是 放 在 $HOME/go， 当 然 也 可 以 是 其 他 位 置 。 

$GOOS and 和 $GOARCH 


这 两 个 环境 变量 表示 目标 代码 的 操作 系统 和 CPU 类 型 。$GOOS 选 项 有 linux、 
freebsd, darwin (Mac OS X 10.5 or 10.6) 和 nacl (Chrome 的 Native Client 接 口 ， 
还 未 完成 )。$GOARCH 的 选项 有 amd64 (64-bit x86， 目 前 最 成 熟 )、386 (32-bit 
x86)、 和 arm (32-bit ARM， 还 未 完成 )。 下 面 是 $SGOOS 和 $GOARCH 的 可 能 组 
a 


oO: 


$GOOS $GOARCH 

darwin 386 

darwin amd64 

freebsd 386 

freebsd amd64 

linux 386 

linux amd64 

linux arm incomplete 
nacl 386 

windows 386 incomplete 


$GOBIN (optional) (可 选 ) 


指明 用 于 存放 go 的 二 进 制程 序 目 录 。 如 果 是 没 设置 $9GOBIN 环 境 变 量 ， 则 默认 是 安 
装 在 $HOME/bin。 如 果 设 置 了 该 变量 ， 需 要 确保 $PATH 变量 也 包含 这 个 路 径 ， 这 
样 编译 器 可 以 找到 正确 的 执行 文件 。 


$GOARM (optional, arm, default=6) 
ARM% Ea 〈 待 补充 ) o 


需要 说 明 的 是 $6GOARCH 和 $GOOS 环 境 变量 表示 的 是 目标 代码 运行 环境 ， 和 当前 
使 用 的 平台 是 无 关 的 。 这 个 对 于 交叉 编译 是 很 方便 的 。 在 .bashrc 文 件 中 设置 以 下 环 


BE: 


export GOROOT=$HOME/go 
export GOARCH=amd64 

export GOOS=linux 

export PATH=. : $PATH : $GOBIN 


source ~/.bashrec 


4. Go 语言 人 门 


4.1. 简介 


本 文 是 关于 Go 编程 语言 的 基础 教程 ， 主 要 面向 有 C/C++ 基 础 的 读者 。 它 并 不 是 一 个 
语言 的 完整 指南 ， 关 于 Go 的 具体 细节 请 参考 语言 规范 一 文 。 在 读 完 这 个 入 门 教程 
后 ， 深入 的 华 可 以 继续 看 Effective Go ， 这 个 文档 将 涉及 到 Go 语言 的 更 多 特性 。 
此 外 ， 还 有 一 个 《Go 语言 三 日 教程 》 系 列 讲座 : 第 一 日 , 第 二 日 , 第 三 日 。 


下 面 将 通过 一 些小 程序 来 演示 go 语言 的 一 些 关 键 特性 。 所 有 的 演示 程序 都 是 可 以 运 
行 的 ， 程 序 的 代码 在 安装 目录 的 /doc/progs/ 子 目 录 中 。 


文中 的 代码 都 会 标 出 在 源 代码 文件 中 对 应 的 行 号 。 同 时 为 了 清晰 起 见 ， 我 们 忽略 了 
源 代码 文件 空白 行 的 行 号 。 


4.2. Hello, th 
让 我 们 从 经 典 的 "Hello, World" 程 序 开 始 : 


05 package main 
07 import fmt "fmt" // Package implementing formatted I/O. 


09 func main() { 
10 fmt.Printf("Hello, world; or KaAnyu?pa k?ope; or CAS 
11 


e 


每 个 Go 源 文件 开头 都 有 一 个 package 声明 语句 ， 指 明 源 文件 所 在 的 包 。 同 时 ， 我 
们 也 可 以 根据 具体 的 需要 来 选择 导入 ( import 语句 ) 特定 功能 的 包 。 在 这 个 例 
子 中 ， 我 们 通过 导入 fmt 包 来 使 用 我 们 熟悉 的 printf HA. 不 过 在 Go 语言 
中 ， Printf 画 数 的 是 大 写字 母 开头 ， 并 且 以 fmt 包 名 作为 前 


经: fmt.Printf 。 


关键 字 func 用 于 定义 本 数 。 在 所 有 初始 化 完成 后 ， 程 序 从 main 包 中 
的 main 画 数 开 始 执行 。 


常量 字符 串 可 以 包含 Unicode 字 符 ， 采 用 UTF-8 编 码 。 实 际 上 ， 所 有 的 Go 语言 源 文 
件 都 采用 UTF-8 编 码 。 


代码 注释 的 方式 和 C++ 类 似 : 





[人 


稍 后 ， 我 们 还 有 很 多 的 关于 打印 的 话题 。 


4.3. 分 号 (Semicolons) 


比较 细心 的 读者 可 能 发 现 前 面 的 代码 中 基本 没有 出 现 分 号 ; 。 其 实在 go 语言 中 ， 
e a a i Ns i 
省 略 的 。 


当然 ， 你 也 可 以 像 C 或 JAVA 中 那样 使 用 分 号 。 不 过 在 大 多 数 情况 下 ， 一 个 完整 语 名 
末尾 的 分 号 都 是 有 go 编译 器 自动 添加 的 一 一 用 户 不 需要 输入 每 个 分 号 。 


关于 分 号 的 详细 描述 ， 可 以 查看 Go 语言 说 明文 档 。 不 过 在 实际 写 代 码 时 ， 只 需要 记 
得 一 行 末 尾 的 分 号 可 以 省 略 就 可 以 了 (对 于 一 行 写 多 个 语句 的 ， 可 以 用 分 号 隔 

开 ) 。 还 有 一 个 额外 的 好 处 是 : 在 退出 大 括号 包围 的 子 区 域 时 ， 分 号 也 是 可 以 省 略 
的 。 


在 一 些 特殊 情况 下 ， 基 至 可 以 写 出 没有 任何 分 号 的 代码 。 不 过 有 一 个 重要 的 地 方 : 
对 于 "if 等 后 面 有 大 括 弧 的 语句 ， 需 要 将 左 大 括 弧 放 在 "if 语句 的 同一 行 ， 如 果 不 这 
祥 的 话 可 能 出 现 编译 错误 。 Go 语言 强制 使 用 将 开始 大 括 弧 放 在 同一 行 末 尾 的 编码 
风格 。 





4.4. 编译 


Go 是 一 个 编译 型 的 语言 。 目 前 有 两 种 编译 器 ， 其 中 "Gccgo" 采 用 GCC 作为 编译 后 
端 。 另 外 还 有 根据 处 理 器 架构 命名 的 编译 器 : 针对 64 位 x86 结 构 为 "6g"， 针 对 32 位 
X86 结构 的 为 "8g" 等 等 。 这 些 go 专 用 的 编译 器 编译 很 快 ， 但 是 产生 的 目标 代码 效率 
比 gccgo 稍 差 一 点 。 目 前 (2009 年 底 ) , go 专用 的 编译 器 的 运行 时 系统 

比 "gccgo" 要 相对 健壮 一 点 。 


下 面 看 看 如 何 编译 并 运行 程序 。 先 是 用 针对 64 位 x86 结 构 处 理 器 的 “6g”: 


$ 6g helloworld.go # 编译 ; 输出 helloworld.6 

$ 61 helloworld.6 # 链接 ; 输出 6.out 

$ 6.out 

Hello, world; or KaAnu?pa K?ouE; or ZASI 世界 
$ 


如 果 是 用 gccgo 编 译 ， 方 法 和 传统 的 gcc 编 译 方法 类 似 : 


$ gccgo helloworld.go 

$ a.out 

Hello, world; or KaAnu?pa K?ouE; or ZASI 世界 
$ 


4.5. Echo 
下 面 的 例子 是 Unix 系 统 中 "echo" 命 令 的 简单 实现 : 


05 package main 


07 import ( 


08 Wost 

09 "flag" // command line option parser 

10 ) 

12 var omitNewline = flag.Bool("n", false, "don't print final 


14 const ( 


15 Space =" " 

16 Newline = "\n" 

17 ) 

19 func main() { 

20 flag.Parse() // Scans the arg list and sets up flags 
21 var s string = "" 

22 for i := 0; i < flag.NArg(); i++ { 
23 if i >0f{ 

24 s += Space 

25 } 

26 s += flag.Arg(i) 

27 

28 if !*omitNewline { 

29 s += Newline 

30 

32 os.Stdout.WriteString(s) 

32 } 





程序 虽然 很 小 ， 但 是 包含 了 go 语言 的 更 多 特性 。 在 上 一 个 的 例子 中 ， 我 们 演示 了 如 
{] FA"func"K# FELKAR. 类 似 的 关键 字 还 有 : "var"、"const" 和 "type" 等 ， 它 们 
可 以 用 于 定义 变量 、 常 量 和 类 型 等 ， 用 法 和 "import" 一 致 。 我 们 可 以 小 括 弧 声明 一 
组 类 型 相同 的 变量 (如 7 一 10 和 14 一 17 行 所 示 ) 。 当 然 ， 也 可 以 分 开 独 立定 义 : 


const Space = " " 
const Newline = "\n" 


程序 首先 导入 os 包 ， 因 为 后 面 要 用 到 包 中 的 一 个 *os.File 类 型 的 Stdout 变量 。 这 
里 的 import 语句 实际 上 是 一 个 声明 ， 和 我 们 在 hello world 程序 中 所 使 用 方法 一 
样 ， 包 的 名 字 标 识 符 (fmt) 为 前 级 用 于 定位 包 中 定位 包 中 的 成 员 ， 包 可 以 是 在 当 


前 目录 或 标准 包 目 录 。 在 导入 包 的 时 候 一 般 会 默认 选用 包 本 身 的 名 字 (在 必要 的 时 
候 可 以 将 导入 的 包 重 新 命名 ) 。 在 “hello world” 程 序 中 ， 我 们 只 是 简单 的 import 
"fmt" f 


如 果 需 要 ， 你 可 以 自己 重新 命名 被 import 的 包 。 但 那 不 是 必须 的 ， 只 在 处 理 包 名 字 
冲突 的 时 候 会 用 到 。 


通过 "os.Stdout"， 我 们 可 以 用 包 中 的 "WriteString?" 方 法 来 输出 字符 串 。 


现在 已 经 导入 "lag" 包 ， 并 且 在 12 行 创建 了 一 个 全 局 变量 ， 用 于 保存 echo 的 "-n" 命 倒 
行 选项 。 变 量 "omitNewline" 为 一 个 只 想 bool 变 量 的 bool 型 指针 。 


在 "main.main" 中 ， 我 们 首先 解析 命令 行 参 数 (20 行 ) ， 然 后 创建 了 一 个 局 部 字符 
串 变 量 用 于 保存 要 输出 的 内 容 。 


变量 声明 语法 如 下 : 


var s string = ""; 


这 里 有 一 个 "var" 关 键 字 ， 后 面 跟着 变量 名 字 和 变量 的 数据 类 型 ， 再 后 面 可 以 
用 "三 ”符号 来 进行 赋 初 值 。 


简洁 是 go 的 一 个 目标 ， 变 量 的 定义 也 有 更 简略 的 语法 。go 可 以 根据 初始 值 来 判断 变 
量 的 类 型 ， 没有 必要 显 式 写 出 数据 类 型 。 也 可 以 这 样 定义 变量 : 

Vanes Sly 
还 有 更 短 的 写法 : 


s := ""; 操作 符 ":=" 闻 在 Go 中 声明 同时 进行 初始 化 一 个 变量 时 会 经 常 使 用 。 下 面 的 代 
码 是 在 "for" 中 声明 并 初始 化 变量 : 


22 for i := 0; i < flag.NArg(); i++ { 


"flag" 包 会 解析 命令 行 参数 ， 并 将 不 是 flag 选 项 的 参数 保存 到 一 个 列表 中 。 可 以 通过 
flag 的 参数 列表 访问 普通 的 命令 行 参数 。 


Go 语言 的 "fo 语句 和 C 语 言 中 有 几 个 不 同 的 地 方 : 第 一 ，for 是 Go 中 唯一 的 循环 语 

句 ，Go 中 没有 while 或 do 语句 ; 第 二 ，for 的 条 件 语句 并 不 需要 用 小 插 号 包 起 来 ， 但 
是 循环 体 却 必 须要 花 括 弧 ， 这 个 规则 同样 适用 于 if 和 switch。 后 面 我 们 会 看 到 for 的 
一 些 例子 。 


在 循环 体 中 ， 通 过 "+=" 操 作 符 向 字符 串 "s" 添 加 要 命令 行 参数 和 空白 。 在 循环 结束 
后 ， 根 据 命令 行 是 否 有 "-m" 选 项 ， 判断 末尾 是 否 要 添加 换行 符 。 最 后 输出 结果 。 


值得 注意 的 地 方 是 "main.main" 芳 数 并 没有 返回 值 ( 画 数 被 定义 为 没有 返回 值 的 类 
型 ) 。 如 果 "main.main" 运行 到 了 末尾 ， 就 表示 “成 功 "。 如 果 想 返回 一 个 出 错 信息 ， 
可 用 系统 调用 强制 退出 : 


os.Exit(1) 


"os" 包 还 包含 了 其 它 的 许多 启动 相关 的 功能 ， 例 如 "os.Args" 是 "flag" 包 的 一 部 分 (用 
来 获取 命令 行 输 入 ) o 


4.6. 类 型 简介 


Go 语言 中 有 一 些 通 用 的 类 型 ， 例 如 "int" 和 "float"， 它 们 对 应 的 内 存 大 小 和 处 理 器 类 
型 相关 。 同 时 ， 也 包含 了 许多 固定 大 小 的 类 型 ， 例 如 "int8" 和 "float64"， 还 有 无 符号 
类 型 "uint" 和 "uint32" 等 。 需要 注意 的 是 ， 即 使 nt" 和 "int32" 占 有 同样 的 内 存 大 小 ， 
但 并 不 是 同一 种 数据 类 型 。 不 过 "byte" 和 "uint8" 对 应 是 相同 的 数据 类 型 ， 它 们 是 字 
符 串 中 字符 类 型 。 


go 中 的 字符 串 是 一 个 内 建 数据 类 型 。 字 符 串 虽然 是 字符 序列 ， 但 并 不 是 一 个 字符 数 
组 。 可 以 创建 新 的 字符 串 ， 但 是 不 能 改变 字符 串 。 不 过 我 们 可 以 通过 新 的 字符 串 来 
达到 想 改变 字符 串 的 目的 。 下 面 列举 "strings.go" 例 子 说 明 字 符 串 的 常见 用 法 : 


11 s := "hello" 

12 if s[1] != 'e' { os.Exit(1) } 
13 s = "good bye" 

14 var p *string = &s 

15 *p = "ciao" 


管 如 何 ， 试 图 修改 字符 串 的 做 法 都 是 被 禁止 的 : 


s[0] = 
(= J = 


se 


Go 中 的 字符 串 和 C++ 中 的 "const strings" 概 念 类 似 ， 字 符 串 指针 则 相当 于 C++ 中 
的 "const strings" 引用 。 


是 的 ， 它 们 都 是 指针 ， 但 是 Go 中 用 法 更 简单 一 些 。 
数组 的 声明 如 下 : 


var arrayofInt [10]int; 


数组 和 字符 串 一 样 也 是 一 个 值 对象 ， 不 过 数组 的 元 素 是 可 以 修改 的 。 不 同 于 C 语 言 
的 是 : "int" 类 型 数组 "arrayOflnt" 并 不 能 转化 为 "int" 指 针 。 因 为 ， 在 Go 话 言 中 数组 是 
一 个 值 对 象 ， 它 在 内 部 保存 "int" 指 针 。 


数组 的 大 小 是 数组 类 型 的 一 部 分 。 我 们 还 可 以 通过 slice (WH) 类 型 的 变量 来 访问 
数组 。 首先 ， 数 据 元 素 的 类 型 要 和 slice (WH) 类 型 相同 ， 然 后 通过 "a: high?" 类 
似 的 语法 来 关联 数组 的 low 到 heigh-1 的 子 区 间 元 素 。 Slices= 和 数组 的 声明 语法 类 

似 ， 但 是 不 像 数 组 那样 要 指定 元 素 的 个 数 ("和 "10?" 的 区 别 ) ; 它 在 内 部 引用 特定 
的 空间 ， 或 者 其 它 数组 的 空间 。 如 果 多 个 Slices 引 用 同一 个 数组 ， 则 可 以 共享 数组 
的 空间 。 但 是 不 同 数组 之 间 是 无 法 共 k 享 内 存 空 间 的 。 


{Go B HSlicesitBaFAN BAe, AXCRARE, SIARA Atb Ee 
效率 很 高 。 但 是 ，Slices 缺 少 对 内 存 的 绝对 控制 比 数组 要 差 一 些 。 例 如 你 只 是 想 要 
一 个 可 以 存放 100 个 元 素 的 空间 ， 那 么 你 就 可 以 选择 数组 了 。 创建 数组 : 


eene e een 


上 面 的 语句 创建 一 个 含有 3 个 元 素 的 int 数 组 。 


当 需 要 传递 一 个 数组 给 画 数 时 ， 你 应 该 将 范 数 的 参数 定义 为 一 个 Slice。 这 样 ， 在 调 
用 函数 的 时 候 ， Ba 自动 转换 为 slice 传 人 。 


比如 以 下 函数 以 slices 类 型 为 参数 (来自 "sum.go") 


09 func sum(a []int) int { // returns an int 
10 Ss := 0 

11 for i := 0; i < len(a); i++ { 

12 s += a[i] 

13 } 

14 return s 

15 } 


PAAR a # H(int)\Esum()\HRHBAWAEA EL. 


为 了 调用 sum 函 数 ， 我 们 需要 一 个 slice 作 为 参数 。 我 们 先 创建 一 个 数组 ， 然 后 将 数 
组 转 为 slice 类 型 : 


s := sum([3]int{1,2,3}[:]) 


如 果 你 创建 一 个 初始 化 的 数组 ， 你 可 以 让 编译 器 自动 计算 数组 的 元 素数 目 ， 只 要 在 
数组 大 小 中 填写 "..." 就 可 以 了 : 


s := sum([...]int{1,2,3}[:]) 


是 实际 编码 中 ， 如 果 不 关心 内 存 的 具体 细节 ， 可 以 用 slice 类 型 (省 略 数组 的 大 小 ) 
来 代替 数组 地 址 为 函数 参数 : 


s := sum([]int{1,2,3}); 


还 有 map 类 型 ， 可 以 用 以 下 代码 初始 化 : 


m := map[string]int{"one":1 , "two":2} 


用 内 建 的 "len()" 酌 数 ， 可 以 获取 map 中 元 素 的 数目 ， 该 函数 在 前 面 的 "sum" 中 用 到 
at. "len()"HX 还 可 以 用 在 strings, arrays, slices, maps, 和 channels 中 。 


还 有 另外 的 "range" 语 法 可 以 用 到 strings, arrays, slices, maps, 和 channels 4, © 
可 以 用 于 "for" 循 环 的 迭代 。 例 如 以 下 代码 


fori 0 reelt len(a); rr ee 
用 "range" 语 法 可 以 写成 : 


for i, v := rangea { ... } 


这 里 的 "i" 对 应 元 素 的 索引 ,，"V" 对 应 元 素 的 值 。 关 于 更 多 的 细节 可 以 参考 Effective 
Go. 


4.7. 申请 内 存 


在 Go 话 言 中 ， 大 部 分 的 类 型 都 是 值 变量 。 例 如 int 或 struct( 结 构 体 ) 或 array( 数 组 ) 类 
型 变量 ， 赋值 的 时 候 都 是 复制 整个 元 素 。 如 果 需 要 为 一 个 值 类 型 的 变量 分 配 空 间 ， 
可 以 用 new() : 


type T struct { a, b int } 
var t *T = new(T); 


或 者 更 简洁 的 写法 : 


t := new(T); 


还 有 另外 一 些 类 型 ， 如 : maps, slices 和 channels( 见 下 面 ) 是 引用 语意 (reference 
semantics) 。 如 果 你 一 个 slice 或 map 内 的 元 素 ， 那 么 其 他 引用 了 相同 slice 或 
map 的 变量 也 能 看 到 这 个 改变 。 对 于 这 三 类 引用 类 型 的 变量 ， 需 要 用 另 一 个 内 建 的 
make() 分 配 并 初始 化 空间 : 


m := make(map[string]int); 


上 目的 代码 定义 一 个 新 的 map 并 分 配 了 存储 空间 。 如 果 只 是 定 一 个 map 而 不 想 分 配 
空间 的 话 ， 可 以 这 样 : 


var m map[string]int; 


它 创 建 了 一 个 nil( 空 的 ) 引 用 并 且 没 有 分 配 存储 空间 。 如 果 你 想 用 这 个 map, 你 必须 使 
用 make 来 分 配 并 初始 化 内 存 空间 或 者 指向 一 个 已 经 有 存储 空间 的 map。 


注意 : new(T) 返回 的 类 型 是 *T , 而 make(T) 返回 的 是 引用 语意 的 T 。 如 果 你 (错误 
的 ) 使 用 new() 分 配 了 一 个 引用 对 象 ， 你 将 会 得 到 一 个 指向 nil 引用 的 指针 。 这 个 相 
当 于 声明 了 一 个 未 初始 化 引用 变量 并 取得 它 的 地 址 。 


4.8. 常量 


虽然 在 Go 中 整数 (integer) 占 用 了 大 量 的 空间 ， 但 是 常量 类 型 的 整数 并 没有 占用 很 多 
空间 。 这 里 没有 像 OLL 或 0x0UL 的 常量 ， 取 而 代 之 的 是 使 用 整数 常量 作为 大 型 高 精 
度 的 值 。 常 量 只 有 在 最 终 被 赋值 给 一 个 变量 的 时 候 才 可 以 会 出 现 浴 出 的 情况 : 
const hardEight = (1 &lt;&lt; 100) &gt;&gt; 97 // legal, 
«| = a: 








BURA Kee RS, FRE SABI : 


var a uint64 = © // a has type uint64, value 0 


a := uint64(0) // equivalent; uses a "conversion" 

i := 0x1234 // i gets default type: int 

var j int = 1e6 // legal - 1000000 is representable in 
x := 1.5 // a float 

i3div2 := 3/2 // integer division - result is 1 
f3div2 := 3./2\. // floating point division - result i: 


E 





(强制 ? ) 转换 只 适用 于 几 种 简单 的 情况 : 转换 整数 (int) 到 去 其 他 的 精度 和 大 小 ， 

整数 (int) 与 浮 点 数 (float) 的 转换 , 还 有 其 他 一 些 简单 情形 。 在 Go 语言 中 ， 系 统 不 会 
对 两 种 不 同类 型 变量 作 任何 隐 式 的 类 型 转换 。 此 外 ， 由 常数 初始 化 的 变量 需要 指定 
确定 的 类 型 和 大 小 。 


4.9./02 


接 下 来 我 们 使 用 open/close/read/write 等 基本 的 系统 调用 实现 一 个 用 于 文件 IO 的 
包 。 让 我 们 从 文件 fle.go 开 始 : 


05 package file 


07 import ( 


08 "os" 

09 "syscall" 

10 ) 

12 type File struct { 

13 fd int // file descriptor number 
14 name string // file name at Open time 
15 } 


文件 的 第 一 行 声明 当前 代码 对 应 一 "file" 一 包 ， 然 后 导入 os 和 syscall 两 个 包 。 包 os 封 
装 了 不 同 操作 系统 底层 的 实现 ， 例 如 将 文件 抽象 成 相同 的 类 型 。 我 们 将 在 系统 接口 
基础 上 封装 一 个 基本 的 文件 IO 接口 。 


另外 还 有 其 他 一 些 比较 底层 的 syscall 包 ， 它 提供 一 些 底 层 的 系统 调用 (system's 
calls)。 


接 下 来 是 一 个 类 型 (type) 定 义 : 用 "type" 这 个 关键 字 来 声明 一 个 类 。 在 这 个 例子 里 数 
据 结 构 (data structure) 名 为 "File"。 为 了 让 这 事变 的 有 趣 些 ， 我 们 的 File 包 含 了 一 个 
这 个 文件 的 名 字 (name) 用 来 描述 这 个 文件 。 


因为 结构 体 名 字 "File" 的 首 字 母 是 大 写 ， 所 以 这 个 类 型 包 (package) 可 以 被 外 部 访 
问 。 在 GO 中 访问 规则 的 处 理 是 非常 简单 的 : 如 果 顶 极 类 型 名 字 首 字母 (包括 : 
function, method, constant or variable, or of a structure field or method) 是 大 写 ， 
那么 引用 了 这 个 包 (package) 的 使 用 者 就 可 以 访问 到 它 。 不 然 名 称 和 被 命名 的 东西 
将 只 能 有 package 内 部 看 到 。 这 是 一 个 要 严格 遵循 的 规则 ， 因 为 这 个 访问 规则 是 由 
编译 器 (compiler) 强 制 规范 的 。 在 GO 中 ， 一 组 公开 可 见 的 名 称 是 "exported"。 


在 这 个 File 例 子 中 ， 所 有 的 字段 (fields) 都 是 小 写 所 以 从 包 外 部 是 不 能 访问 的 ， 不 过 
我 们 在 下 面 将 会 一 个 一 个 对 外 访问 的 出 口 (exported) 一 一 一 个 以 大 写字 母 开 头 的 方 


N 
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首先 是 一 个 创建 File 结 构 体 的 画 数 : 


17 func newFile(fd int, name string) *File { 
18 if fd< © { 

19 return nil 

20 } 

21 return &File{fd, name} 


这 将 返回 一 个 指向 新 File 结 构 体 的 指针 ， 结 构 体 存 有 文件 描述 符 和 文件 名 。 这 段 代 
码 使 用 了 GO 的 复合 变量 (composite literal) 的 概念 ， 和 创建 内 建 的 maps 和 arrays 类 
型 变量 一 样 。 要 创建 在 堆 (heap-allocated) 中 创建 一 个 新 的 对 象 ， 我 们 可 以 这 样 
Ę : 


n := new(File); 
n.fd = fd; 
n.name = name; 
return n 


如 果 结 构 比 较 简 单 的 话 ， 我 们 可 以 直接 在 返回 结构 体 变 量 地 址 的 时 候 初 始 化 成 员 字 
段 ， 如 前 面 例 子 的 21 行 代码 所 示 。 


我 们 可 以 用 前 面 的 函数 (newFile) 构造 一 些 File 类 型 的 变量 ， 返 回 File : 


24 var ( 

25 Stdin = newFile(0, "/dev/stdin") 
26 Stdout = newFile(1, "/dev/stdout") 
27 Stderr = newFile(2, "/dev/stderr") 
28 ) 


x BMnewFileZzARaA, BEZART» RAE Open : 


30 func Open(name string, mode int, perm uint32) (file *File, 
31 r, e := syscall.Open(name, mode, perm) 

32 if e != £ { 

33 err = os.Errno(e) 

34 } 

35 return newFile(r, name), err 

36 } 





EJTEM SERNA. A, KAOpenk Eg Ac (multi-value) : 一 个 
File 指 针 和 一 个 error( 等 一 下 会 介绍 errors)》 我 们 用 括号 来 表 来 声明 返回 多 个 变量 值 
(multi-value)， 语 法 上 它 看 起 来 像 第 二 个 参数 列表 。syscall.Open 系 统 调 用 同样 也 
是 返回 多 个 值 multi-value。 接 着 我 们 能 在 31 行 创建 了 r 和 e 两 个 变量 用 于 保存 
syscall.Open 的 返回 值 。 男 数 最 终 也 是 返回 2 个 值 ， 分 别 为 File 指 针 和 一 个 error。 如 
果 syscall.Open 打 开 失 败 ， 文 件 描述 r 将 会 是 个 负 值 ，newFile 将 会 返回 nil。 


关于 错误 : 0S 包 包含 了 一 些 常见 的 错误 类 型 。 在 用 户 自己 的 代码 中 也 尽量 使 用 这 些 
通用 的 错误 。 joni. 我 们 用 os.Error 函 数 将 Unix 的 整数 错误 代码 转换 为 go 
语言 的 错误 类 型 。 


现在 我 们 可 以 创建 Files, 我 们 为 它 定 义 了 一 些 常 用 的 方法 (methods)。 要 给 一 个 类 型 
定义 一 个 方法 (method)， 需要 在 函数 名 前 增加 一 个 用 于 访问 当前 类 型 的 交 量 。 这 些 
是 为 *File 类 型 创建 的 一 些 方法 : 


38 func (file *File) Close() os.Error { 


39 if file == nil { 

40 return os.EINVAL 

41 } 

42 e := syscall.Close(file.fd) 

43 file.fd = -1 // so it can't be closed again 
44 if e !=0 { 

45 return os.Errno(e) 

46 

47 return nil 

48 } 

50 func (file *File) Read(b []byte) (ret int, err os.Error) { 
51 if file == nil { 

52 return -1, os.EINVAL 

53 } 

54 r, e := syscall.Read(file.fd, b) 
55 if e !=0 { 

56 err = os.Errno(e) 

57 

58 return int(r), err 

59 } 

61 func (file *File) Write(b []byte) (ret int, err os.Error) : 
62 if file == nil { 

63 return -1, os.EINVAL 

64 } 

65 r, e := syscall.Write(file.fd, b) 
66 if e !=0{ 

67 err = os.Errno(e) 

68 

69 return int(r), err 

70 } 

72 func (file *File) String() string { 
73 return file.name 

74 } 





这 些 并 没有 隐 含 的 this 指 针 (参考 C 十 十 类 ) ， 而 且 类 型 的 方法 (methods) 也 不 是 定 


义 在 struct 内 部 struct 结 构 只 声明 数据 成 员 (data members)。 事 实 上 ， 我 们 可 以 
给 任意 数据 类 型 定义 方法 ， 例 如 : 整数 (integer)， 数 组 (array) 等 。 后 面 我 们 会 有 一 
个 给 数组 定义 方法 的 例子 。 


String 这 个 方法 之 所 以 会 被 调用 是 为 了 更 好 的 打印 信息 ， 我 们 稍 后 会 详细 说 明 。 


方法 (methods) 使 用 os.EINVAL 来 表示 (os.Error 的 版 本 )Unix 错 误 代 码 EINVAL。 在 os 
包 中 针对 标准 的 error 变 量 定义 各 种 错误 常量 。 


现在 我 们 可 以 使 用 我 们 自己 创建 的 包 (package) 了 : 





05 package main 


07 import ( 


08 a/f rilet 

09 "fmt" 

10 "os" 

11 ) 

13 func main() { 

14 hello := []byte("hello, world\n") 

15 file.Stdout.write(hello) 

16 file, err := file.Open("/does/not/exist", 0, 0) 
17 if file == nil { 

18 fmt.Printf ("can't open file; err=%s\n", err.String 
19 os.Exit(1) 

20 } 

21 } 





这 个 "./" 在 导入 (import)"./file" 时 告诉 编译 器 (compiler) 使 用 我 们 自己 的 package， 而 
在 默认 的 package 路 径 中 找 。 


是 
最 后 ， 我 们 来 执行 这 个 程序 : 


$ 6g file.go # compile file package 

$ 6g helloworld3.go # compile main package 

$ 61 -o helloworld3 helloworld3.6 # link - no need to mentic 
$ helloworld3 

hello, world 

can't open file; err=No such file or directory 

$ 


国生 和 下 





4.10. Rotting cats 


在 我 们 上 面 创 建 的 fle 包 (package) 基 础 之 上 ， 实 现 一 个 简单 的 Unix 工 具 "cat(1)", 
"progs/cat.go": 


05 package main 


07 import ( 


08 "./file" 

09 "flag" 

10 "fmt" 

11 "os" 

12 ) 

14 func cat(f *file.File) { 

15 const NBUF = 512 

16 var buf [NBUF]byte 

17 for { 

18 switch nr, er := f.Read(buf[:]); true { 

19 case nr < 0: 

20 fmt.Fprintf(os.Stderr, "cat: error reading fror 
21 os .Exit(1) 

22 case nr == 0: // EOF 

23 return 

24 case nr > 0: 

25 if nw, ew := file.Stdout.Write(buf[O:nr]); nw 
26 fmt.Fprintf(os.Stderr, "cat: error writing 
27 } 

28 } 

29 } 

30 } 

32 func main() { 

33 flag.Parse() // Scans the arg list and sets up flags 
34 if flag.NArg() == 0 { 

35 cat(file.Stdin) 

36 } 

37 for i := 0; i < flag.NArg(); i++ { 

38 f, err := file.Open(flag.Arg(i), 9, 9) 

39 if f == nil { 

40 fmt.Fprintf(os.Stderr, "cat: can't open %s: eri 
41 os.Exit(1) 

42 

43 cat(f) 

44 f.Close() 

45 } 


46 } 








现在 应 该 很 容易 被 理解 ， 但 是 还 有 些 新 的 语法 "switch". 比如 : 包括 了 "for" 循 环 ， 
"if" 和 "switch" 初 始 化 的 语句 。 在 "switch" 语 句 的 18 行 用 了 "f.Read()" 函 数 的 返回 
值 "nr" 和 "er" 做 为 变量 (25 行 中 的 " 计 也 采用 同 祥 的 方法 )。 这 里 的 "switch" 语 法 和 其 他 
语言 语法 基本 相同 ， 每 个 分 支 (cases) 从 上 到 下 坦 找 是 否 与 相关 的 表达 式 相 同 ， 分 
支 (case) 的 表达 式 不 仅仅 是 常量 (constants) 或 整数 (integers), 它 可 以 是 你 想到 的 任 


这 个 "switch" 的 值 永远 是 " 真 (true)", 我 们 会 一 直 执 行 它 , 就 像 "or 语句 ， 不 写 值 默认 
是 " 真 "(true). 事实 上 ，"switch" 是 从 "if-else" 由 来 的 。 在 这 里 我 们 要 说 明 , "switch" 语 
句 中 的 每 个 "分 支 "(case) 都 默认 隐藏 了 "break". 


在 25 行 中 调用 "Write()" 采 用 了 slicing 来 取得 buffer 数 据 . 在 标准 的 GO 中 提供 了 Slices 
对 |/O buffers 的 操作 。 


现在 让 我 们 做 一 个 "cat" 的 升级 版 让 "rot13" 来 处 理 输入 , 就 是 个 简单 的 字符 处 理 ， 但 
是 要 采用 GO 的 新 特性 "接口 (interface)" 来 实现 。 


这 个 "cat()" 使 用 了 2 个 子 程序 "f"':"Read()" 和 "String", 让 我 们 定义 这 2 个 接口 ， 源码 参 
考 "progs/cat_rot13.go" 


26 type reader interface { 

27 Read(b []byte) (ret int, err os.Error) 
28 String() string 

29 


任何 类 型 的 方法 都 有 reader 这 两 个 方法 也 就 是 说 实现 了 这 两 个 方法 ， 任何 类 
型 的 方法 都 能 使 用 。 由 于 file.File 实现 了 reader 接口 ， 我 们 就 可 以 让 cat 的 子 程序 
访问 reader 从 而 取代 了 *file.File 并 且 能 正常 工作 ， 让 我 们 来 些 第 二 个 类 型 实现 
reader , 一 个 关注 现 有 的 reader ， 另 一 个 rot13 只 关注 数据 。 我 们 只 是 定义 了 这 个 
类 型 和 实现 了 这 个 方法 并 没有 做 其 他 的 内 部 处 理 , 我 们 实现 了 第 二 个 reader 接口 . 





31 type rotate13 struct { 


32 source reader 

33 } 

35 func newRotate13(source reader) *rotate13 { 
36 return &rotate13{source} 

37 } 

39 func (r13 *rotate13) Read(b []byte) (ret int, err os.Error` 
40 r, e := r13.source.Read(b) 

41 for i i= 07 i s re itt d 

42 b[i] = rot13(b[i]) 

43 } 

44 return r, e 

45 } 

47 func (r13 *rotate13) String() string { 

48 return r13.source.String() 

49 } 


50 // end of rotate13 implementation 





(4247 AY"rot1 3" KARGER fi A, A UREE AIT e) 
为 了 使 用 新 的 特性 ， 我 们 定义 了 一 个 标记 (flag): 


14 var roti3Flag = flag.Bool("roti3", false, "roti3 the input' 





用 它 基 本 上 不 需要 修改 "cat()" 这 个 画 数 : 


52 func cat(r reader) { 


53 const NBUF = 512 

54 var buf [NBUF]byte 

56 if *roti3Flag { 

57 r = newRotate13(r) 

58 } 

59 for { 

60 switch nr, er := r.Read(buf[:]); { 

61 case nr < 0: 

62 fmt.Fprintf(os.Stderr, "cat: error reading fror 
63 os.Exit(1) 

64 case nr == 0: // EOF 

65 return 

66 case nr > 0: 

67 nw, ew := file.Stdout.Write(buf[O:nr] ) 

68 if nw !=nr { 

69 fmt.Fprintf(os.Stderr, "cat: error writing 
70 } 

71 } 

72 } 

73 } 





(我 们 应 该 对 main 和 cat 单独 做 些 封 狼 ， 不 仅仅 是 对 类 型 参数 的 修改 ， 就 当 是 练习 ) 
从 56 行 到 58 行 : 如 果 rot13 标记 是 真 ， 封 装 的 reader 就 会 接受 数据 并 传 给 rotate13 
并 义理 . ; 这 个 接口 的 值 是 变量 ， 不 是 指针 ， 这 个 参数 是 reader 类 型 ， 不 是 
*reader , 尽管 后 面 转换 为 指向 结构 体 的 指针 。 


% echo abcdefghijklmnopqrstuvwxyz | ./cat 
abcdefghijklmnopqrstuvwxyz 

% echo abcdefghijklmnopqrstuvwxyz | ./cat --rot13 
nopqrstuvwxyzabcdefghijklm 

% 


也 许 你 会 说 使 用 注入 依赖 (dependency injection) 能 轻松 的 让 接口 以 一 个 文件 描述 符 
执行 。 


接口 (interfaces) 是 Go 的 一 hte 一 个 接口 是 由 类 型 实现 的 ， 接 口 就 是 声明 该 类 
的 所 有 方法 。 也 就 是 说 一 类 型 可 以 实现 多 个 不 同 的 接口 ， 没有 任何 关 型 的 限制 ， 
就 像 我 们 的 例子 "rot13". "file. File" 这 个 类 型 实现 了 "reader", 它 也 能 实现 "writer", 或 通 
过 其 他 的 方法 来 实现 这 个 接口 。 参考 空 接口 (empty interface) 


type Empty interface {} 


任何 类 型 都 默认 实现 了 空 接 口 ， 我 们 可 以 用 空 接口 来 保存 任意 类 
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4.11. Sorting 


接口 (interfaces) 提 供 了 一 个 简单 形式 的 多 态 (polymorphism). 他 们 把 对 象 的 定义 和 
如 何 实现 的 分 开 人 处 理 ， 人 允许 相同 的 接口 可 以 有 不 能 的 实现 方法 。 


参考 这 个 简单 的 排序 算法 (sort algorithm)"progs/sort.go" 


13 func Sort(data Interface) { 


14 for i := 1; i < data.Len(); i++ { 

15 for j := i; j > © && data.Less(j, j-1); j-- { 
16 data.Swap(j, j-1) 

17 

18 } 

19 } 


我 们 要 封装 这 个 排序 (sort) 的 接口 (interface) 仅 需要 三 个 方法 。 


07 type Interface interface { 


08 Len() int 

09 Less(i, j int) bool 
10 Swap(i, j int) 

11 } 


我 们 可 以 用 任何 类 型 的 "Sort" 去 实现 "Len", "Less" 和 "Swap". 这 个 "sort" 包 里 面 包含 
— £75 (methods). 下 面 是 整 型 数组 的 代码 : 


33 type IntArray []int 


35 func (p IntArray) Len() int { return len(p) } 
36 func (p IntArray) Less(i, j int) bool 4{ return p[i] < p[j. 
37 func (p IntArray) Swap(i, j int) { p[i], p[j] = p[j], 





你 看 到 的 是 一 个 没有 任何 类 型 的 "结构 体 "(non-struct type). 在 你 的 包 里面 你 可 以 定 
义 任何 你 想 定 义 的 类 型 . 


现在 用 "progs/sortmain.go" 程 序 进 行 测 试 ， 用 "sort" 包 里 面 的 排序 函数 进行 排序 。 


12 
13 
14 
15 
16 
17 
18 
19 


func ints() { 
data := []int{74, 59, 238, -784, 9845, 959, 905, 0, Ọ, 
a := sort.IntArray(data) 
sort.Sort(a) 
if !sort.IsSorted(a) { 
panic("fail") 
} 








如 果 我 们 为 sort 提 供 一 个 新 类 型 ， 我 们 就 需要 为 这 个 类 型 实现 三 个 方法 ， 如 下 : 


30 
31 
32 
33 
34 


36 
37 
38 


40 
41 
42 


天 


type day struct { 
num int 
shortName string 
longName string 


} 


type dayArray struct { 
data []*day 


} 

func (p *dayArray) Len() int { return len(p.daté 
func (p *dayArray) Less(i, j int) bool { return p.data[i] 
func (p *dayArray) Swap(i, j int) { p.data[i], p.daté 





4.12. 打印 输出 
前 面 例 子 中 涉及 到 的 打印 都 比较 简单 。 在 这 一 节 中 ， 我 们 将 要 讨论 Go 语言 格式 化 输 
出 的 功能 。 


我 们 已 经 用 过 "fmt" 包 中 的 "Printf" 和 "Fprintf' 等 输出 函数 。"fmt" 包 中 的 "Printf" 男 数 的 
完整 说 明 如 下 : 


Printf (format string, v ...) (n int, errno os.Error) 


A E 和 C 语 言 中 "stdarg.h" 中 的 宏 类 似 。 不 过 Go 中 ， 可 变 参 
数 是 通道 一 个 空 接口 ("interface {") 和 反射 (reflection) 库 实 现 的 。 反 射 特性 可 
以 帮助 "Printf 画 数 很 好 的 获取 参数 的 详细 特征 。 


在 C 语 言 中 ，printf 范 数 的 要 格式 化 的 参数 类 型 必须 和 格式 化 字符 串 中 的 标志 一 致 。 
不 过 在 Go 语言 中 ， 这 些 细节 都 被 简化 了 。 我 们 不 再 需要 "%llud" 之 类 的 标志 ， 只 
用 "%d" 表 示 要 输出 一 个 整数 。 至 于 对 应 参数 的 实际 类 型 ，"Printf" 可 以 通过 反射 获 
取 。 例 如 : 


10 var u64 uint64 = 1<<64-1 
11 fmt.Printf("%d %d\n", u64, int64(u64)) 


输出 


18446744073709551615 -1 


最 简单 的 方法 是 用 "%v" 标 志 ， 它 可 以 以 适当 的 格式 输出 任意 的 类 型 (包括 数组 和 结 
构 ) 。 下 面 的 程序 ， 


14 type T struct { 

15 a int 

16 b string 

17 } 

18 t := T{77, "Sunset Strip"} 

19 a := []int{1, 2, 3, 4} 

20 ate Printf("%v %v vAn", u64, t, a) 
将 输出 


18446744073709551615 {77 Sunset Strip} [1 2 3 4] 


如 果 是 使 用 "Print" 或 "PrintIn" 函 数 的 话 ， 蔡 至 不 需要 格式 化 字符 串 。 这 些 辑 数 会 和 针对 
数据 类 型 自动 作 转 换 。 Print" HERB Ea Soe GGA, Eo 

ce eee 的 输出 基础 上 增加 一 个 换行 。 一 下 两 种 输出 方式 和 前 面 的 输出 结 
Rez 的 。 


21 FME Peat (GG A eee eat een) 
22 fmt.Printin(u64, t, a) 


RE HP'"Print "Print" a Was wy KB, 之 需要 为 该 结构 实现 一 

个 "String()" 方 法 ， 返回 相应 的 字符 串 就 可 以 了 。 打 印 画 数 会 先 检测 该 类 型 是 否 实现 
a 如 果实 现 了 则 以 该 方法 返回 字符 串 作 为 输出 。 下 面 是 一 个 简单 的 
列子 


09 type testType struct { 


10 a int 

alia b string 

12 } 

14 func (t *testType) String() string { 
15 return fmt.Sprint(t.a) + " " + t.b 
16 } 

18 func main() { 

19 t := &testType{77, "Sunset Strip"} 
20 fmt.Println(t) 

21 } 


因为 *testType 类 型 有 String) 方法 ， 因 此 格式 化 函数 用 它 作 为 输出 结果 : 


77 Sunset Strip 


前 面 的 例子 中 ，"String()" 方 法 用 到 了 "Sprint”( 从 字面 意思 可 以 猜测 函数 闻 返 回 一 个 
字符 串 ) 作为 格式 化 的 基础 画 数 。 在 Go 中 ， 我 们 可 以 递 为 使 用 "fmt" 库 中 的 本 数 来 
为 格式 化 服务 。 


"Printf" 汞 数 的 另 一 种 输出 是 "%T" 格 式 ， 它 输出 的 内 容 更 加 详细 ， 可 以 作为 调试 信息 


o 


自己 实现 一 个 功能 完备 ， 可 以 输出 各 种 格式 和 精度 的 函数 是 可 能 的 。 不 过 这 不 是 该 
教程 的 重点 ， 大 家 可 以 把 它 当 作 一 个 课 后 练习 。 
ic BEA KE], "Print NASM Ae g BSB A" String) HARÉ, KM 


+, Rm 需要 先 将 变量 转换 为 Stringer 接 口 类 型 ， 如 果 转 换 成 功 则 表示 
有 "String()" 方 法 。 下 面 是 一 个 演示 的 例子 


type Stringer interface { 
String() string 


} 
s, Ok := v.(Stringer); // Test whether v implements "Stı 
if ok { 
result = s.String() 
} else { 
result = defaultOutput(v) 
} 


«| 本 








这 里 用 到 了 类 型 断言 ("v.(Stringer)")， 用 来 判断 变量 "v" 是 否 可 以 满足 "Stringer" 接 
口 。 如 果 满 足 ，"s" 将 对 应 转换 后 的 Stringer 接 口 类 型 并 且 "ok" 被 设置 为 "true"。 然 后 
我 们 通过 "s"， 以 Stringer 接 口 的 方式 调用 String() 函 数 。 如 果 不 满足 该 接口 特 

征 ，"ok" 闻 被 设置 为 false。 


"Stringer" 接 口 的 命名 通常 是 在 接口 方法 的 名 字 后 面 加 e?r 后 级 ， 这 里 
是 "String+er"。 


Go 中 的 打印 函数 ， 除 了 "Printf'" 和 "Sprintf" 等 之 外 ， 还 有 一 个 "Fprintf" 函 数 。 不 
过 "Fprintf" 函 数 和 的 第 一 个 参数 并 不 是 一 个 文件 ， 而 是 一 个 在 "io" 库 中 定义 的 接口 类 
型 : 


type Writer interface { 
Write(p []byte) (n int, err os.Error); 
} 


这 里 的 接口 也 是 采用 类 似 的 命名 习惯 ， 类 型 的 接口 还 
有 "io.Reader" 和 "io.ReadWriter?" 等 。 在 调用 "Fprintf" 范 数 时 ， 可 以 用 实现 
了 "Write" 方 法 的 任意 类 型 变量 作为 参数 ， 例 如 文件 、 网 络 、 管 道 等 等 。 


4.13. 生成 素数 


这 里 我 们 要 给 出 一 pes mg ere 这 是 一 个 非常 大 的 课题 ， 我 们 这 
里 只 是 给 出 一 =i 些 要 点 


素数 短 选 是 一 个 比较 经 典 的 问题 (这 里 侧重 于 Eratosthenes 素 数 筛选 算法 的 并 行 特 
征 ) 。 它 以 全 部 的 自然 后 为 筛选 对 象 。 首 选 从 第 一 个 素数 2 开始 ， 后 续 数列 中 是 已 
经 素数 倍数 的 数 去 掉 。 每 次 条 $ 选 可 以 得 到 一 个 新 的 素数 ， 然 后 将 新 的 素数 加 入 算 选 
器 ， 继 闯 第 选 后 面 的 自然 数列 (这 里 要 参考 算法 的 描述 调整 ) 。 


这 里 是 算法 工作 的 原理 图 。 每 个 杠 对 应 一 个 素数 筛选 器 ， 并 且 将 剩 下 的 数列 传 给 
一 个 素数 第 进行 第 选 。 





为 了 产生 整数 序列 ， 我 们 使 用 管道 。 管 道 可 以 用 于 连接 两 个 并 行 的 处 理 单 。 在 Go 语 
BAH, 管道 由 运行 时 库 管理 ， 可 以 用 "make" 来 创建 新 的 管道 。 
这 是 "progs/sieve.go" 程 序 的 第 一 个 辑 数 : 

09 // Send the sequence 2, 3, 4, ... to channel 'ch'. 

10 func generate(ch chan int) { 

11 rop a a ee aaar f 

12 ch <- i // Send 'i' to channel 'ch'. 

13 } 

14 } 


PEBX"generate" AF 42, 3, 4, 5, ... 自 然 数 序 列 ， 然 后 依次 发 送 到 管道 。 这 里 用 到 
了 二 元 操作 符 "<-"， 它 用 于 向 管道 发 送 数据 。 当 管道 没有 接受 者 的 时 候 会 阻塞 ， 直 
到 有 接收 者 从 管道 接受 数据 为 止 。 


过 滤器 范 数 有 三 个 参数 : 输入 输出 管 过 和 用 于 过 滤 当 输 入 管道 读 出 来 的 数 
不 能 被 过 if IS RENEE ERS , 则 将 当前 整数 发 送 到 输出 管道 。 这 里 用 到 了 "<-" 操 作 符 ， 
它 用 于 从 管道 读 取 数据 。 


16 // Copy the values from channel 'in' to channel '‘out', 


17 // removing those divisible by 'prime'. 

18 func filter(in, out chan int, prime int) { 

19 for { 

20 i := <-in // Receive value of new variable 'i' fr« 
2al if i % prime != © { 

22 out <- i // Send 'i' to channel 'out'. 

23 } 

24 } 

25 } 








整数 生成 器 generator 函 数 和 过 滤器 filters 是 并 行 执行 的 。 Go 语言 有 自己 的 并 发 程序 
设计 模型 ， 这 个 和 传统 的 进程 /线程 / 轻 量 线程 类 似 。 为 了 区 别 ， 我 们 把 Go 语言 中 的 
并 行程 序 称 为 goroutines。 如 果 一 个 函数 要 以 goroutines 方 式 并 行 执行 ， 只 要 

用 "go" 关 键 字 作为 画 数 调用 的 前 缀 即 可 。 goroutines 和 它 的 启动 线程 并 行 执行 ， 但 
是 共享 一 个 地 址 空间 。 例 如 ， 以 goroutines 方 式 执 行 前 面 的 Sum 郴 数 : 


go sum(hugeArray); // calculate sum in the background 


如 果 想 知道 计算 什么 时 候 结束 ， 可 以 让 Sum 用 管道 把 结果 返回 : 


ch := make(chan int); 

go sum(hugeArray, ch); 

// ... do something else for a while 

result := &lt;-ch; // wait for, and retrieve, result 


再 回 到 我 们 的 素数 第 选 程序 。 下 面 程序 演示 如 何 将 不 同 的 素数 得 链接 在 一 起 : 


28 func main() { 


29 ch := make(chan int) // Create a new channel. 
30 go generate(ch) // Start generate() as a goroutine. 
31 for { 
32 prime := <-ch 
33 fmt.Println(prime) 
34 chi := make(chan int) 
35 go filter(ch, chi, prime) 
36 ch = chi 
37 } 
38 } 
2947 C18 "generate", AF ttm AAR 〈 从 2 开始 ) 。 然 后 从 


fa’ 管道 然 


道 。 


Sieve 程 序 还 可 以 写 的 更 简洁 一 点 。 这 里 是 "generate" 的 改进 ， 代 码 在 
"progs/sieve1.go" 中 : 


10 func generate() chan int { 
11 ch := make(chan int) 

12 go func(){ 

13 Or Sa 27 P aken oi 
14 ch <- i 

15 } 

16 }() 

17 return ch 

18 } 


新 完善 的 generate 函 sien ARE cle allel 作 。 它 创建 输出 管道 ， 然 后 启动 
goroutine 用 于 产生 整数 序列 ， 最 后 返回 输出 管道 。 它 类 似 于 一 个 并 发 程序 的 工厂 
函数 ， 完 成 后 返回 一 个 用 于 链接 的 管道 。 


第 12-16 行 用 go 关键 字 馈 动 一 个 匿名 函数 。 需 要 注意 的 是 ，generate 函 数 的 "ch" 变 
量 对 于 匿名 函数 是 可 见 ， 并 且 "ch" 交 量 在 generate 函 数 返 回 后 依然 存在 (因为 匿名 
的 goroutine 还 在 运行 ) 。 


这 里 我 们 采用 过 滤器 "filter" 来 筛选 后 面 的 素数 : 


21 func filter(in chan int, prime int) chan int { 
22 out := make(chan int) 

23 go func() { 

24 for { 

25 if i := <-in; i % prime !=0 { 
26 out <- i 

27 } 

28 } 

29 }() 

30 return out 

31 } 


函数 "sieve" 对 应 义理 的 一 个 主 循环 ， 它 只 是 依次 将 数列 交 给 后 面 的 素数 筛选 器 进行 
筛选 。 如 果 遇 到 新 的 素数 ， 再 输出 素数 后 以 该 素数 创建 信 的 条 选 器 。 


=RBWAO 


func sieve() chan int { 
out := make(chan int) 
go func() { 
ch := generate() 
for { 
prime := <-ch 
out <- prime 
ch = filter(ch, prime) 


} 
}() 


return out 


启动 素数 生成 服务 器 ， 然 后 打印 从 管道 输出 的 素数 : 


func main() { 
primes := sieve() 
for { 
fmt.Println(<-primes) 
} 


4.14. Multiplexing 


基于 管道 ， 我 们 可 以 很 容易 实现 一 个 支持 多 路 客户 端的 服务 器 程序 。 采 用 的 技巧 是 
将 每 个 客 户 端 私有 的 通信 管道 作为 消息 的 一 部 分 发 送 给 服务 器 ， 然 后 服务 器 通过 这 
些 管道 和 客户 端 独立 通信 。 现 实 中 的 服务 器 实现 都 很 复杂 ， 我 们 这 里 只 给 出 一 个 服 
务 器 的 简单 实现 来 展现 前 面 描述 的 技巧 。 首 先 定义 一 个 "request" 类 型 ， 里 面包 含 一 
个 客户 端的 通信 管道 。 


09 type request struct { 


10 a, b int 
11 replyc chan int 
12 } 


服务 器 对 客户 端 发 送 过 来 的 两 个 整数 进行 运算 。 下 面 是 具体 的 男 数 ， 辑 数 在 运算 完 
之 后 将 结构 通过 结构 中 的 管道 返回 给 客户 端 。 


14 type binOp func(a, b int) int 


16 func run(op binOp, req *request) { 


17 reply := op(req.a, req.b) 
18 req.replyc <- reply 
19 } 


B14 ELT "binOp"WHRAB, AT xt me SEM Tie R. 


服务 器 routine 线 程 是 一 个 无 限 循环 ， 它 接受 客户 端 请 求 。 然 后 为 每 个 客户 端 启动 一 
个 独立 的 routine 线 程 ， 用 于 处 理 客户 数据 (不 会 被 某 个 客户 mB Ze) 。 


21 func server(op binOp, service chan *request) { 
22 for { 

23 req := <-service 

24 go run(op, req) // don't wait for it 
25 

26 } 


启动 服务 器 的 方法 也 是 一 个 类 似 的 routine 线 程 ， 然 后 返回 服务 器 的 请 求 管道 。 


28 func startServer(op binOp) chan *request { 
29 req := make(chan *request ) 

30 go server(op, req) 

31 return req 


这 里 是 一 个 简单 的 测试 。 首 先 和 启动 服务 器 ， 义 理 范 数 为 计算 两 个 整数 的 和 。 接 着 向 
服务 器 发 送 "N" 个 请 求 〈 无 阻塞 ) 。 当 所 有 请 求 都 发 送 完了 之 后 ， 再 进行 验证 返回 
结果 。 


34 func main() { 


35 adder := startServer(func(a, b int) int { returna + b 
36 const N = 100 

37 var reqs [N]request 

38 for i := 0; i < N; i++ { 

39 req := &reqs[i] 

40 req.a = i 

41 req.b =i+N 

42 req.replyc = make(chan int) 

43 adder <- req 

44 } 

45 for i := N-1; i >= 0; i-- { // doesn't matter what oi 
46 if <-reqs[i].replyc != N + 2*i { 

47 fmt.Printin("fail at", i) 

48 } 

49 } 

50 fmt.Printin("done") 

51 } 





前 面 的 服务 器 程序 有 个 小 问题 : manok 2, RAAKAA, MEAT 
有 一 些 客户 端 被 阻塞 在 管道 通信 中 。 为 了 人 处理 这 个 问题 ， 我 们 可 给 服务 器 增加 一 个 
控制 管道 ， 用 于 退出 服务 器 。 


32 func startServer(op binOp) (service chan *request, quit ché 
33 service = make(chan *request) 

34 quit = make(chan bool) 

35 go server(op, service, quit) 

36 return service, quit 

37 } 





首先 给 "server" 酌 数 增加 一 个 控制 管道 参数 ， 然 后 这 样 使 用 : 


21 func server(op binOp, service chan *request, quit chan boo: 


22 for { 

23 select { 

24 case req := <-service: 

25 go run(op, req) // don't wait for it 
26 case <-quit: 

27 return 

28 } 

29 } 

30 } 


«| o 








在 服务 器 函数 中 ，"select" 操 作 服 用 于 从 多 个 通讯 管道 中 选择 一 个 就 绪 的 管道 。 如 果 
所 有 的 管道 都 没有 数据 ， 那么 将 等 待 知道 有 任意 一 个 管道 有 数据 。 如 果 有 多 个 管道 
就 绪 ， 则 随即 选择 一 人 个。 服务器 义理 客户 端 请 求 ， 如 果 有 退出 消息 则 退出 。 


后 是 在 main 函 数 中 保存 "quit" 管 道 ， 然 后 在 退出 的 时 候 向 服务 线程 发 送 停止 命 


40 adder, quit := startServer(func(a, b int) int { return 


55 quit <- true 
| ER 
出 一 些 简单 的 例子 





当然 ，Go 语 言及 并 行 编程 要 讨论 的 问题 很 多 。 这 个 人 门 只 是 8 
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5. Effective Go 


5.1. 简介 


Go 是 一 个 新 的 语言 。 虽 然 它 从 其 他 语言 中 借鉴 了 一 些 特性 ， 但 是 Go 语言 的 编程 方 
式 和 其 他 是 有 本 质 却 别 的 。 如 果 只 是 简单 的 将 C++ 或 Java 等 代码 翻译 为 Go 代码 是 
不 可 能 得 到 最 优 的 Go 代码 的 。 java 程 序 员 用 java 的 思维 方式 编程 ， 并 不 是 Go 的 思 
维 方式 。 如 果 采 用 go 的 思维 方式 ， 一 个 问题 可 能 有 完全 不 同 的 解决 方法 。 因 此 ， 如 
果 要 真正 的 用 好 Go 语言 ， 理 解 它 的 语言 特性 和 设计 思想 是 很 重要 的 。 另 外， 还 要 
知道 Go 语言 的 变 成 风格 ， 例 如 命名 方式 、 格 式 化 、 程 序 结构 等 等 ， 采 用 通用 的 方 
式 也 便于 和 其 他 的 Go 程序 员 交流。 


该 文档 对 于 如 何 编 写 清晰 优雅 的 Go 程序 给 出 一 些 建 议 。 它 是 Go 语法 说 明 和 Go 语言 
入 门 教程 的 补充 。 


5.1.1. 例子 


Go 源 代 码 不 仅 包含 了 核心 库 的 实现 ， 还 有 很 多 如 何 使 用 语言 的 例子 。 如 果 在 使 用 
go 的 过 程 中 遇 到 问题 ， 或 者 想 了 解 某 些 库 的 内 部 工作 机 制 ， 可 以 直接 参考 源 代 码 找 


到 答案 。 


oOo 


5.2. 格式 化 


格式 化 是 一 个 最 有 争议 的 问题 。 虽 然 人 可 以 适应 各 种 不 同 的 风格 ， 不 过 如 果 大 家 都 
遵循 一 个 默认 统一 的 风格 是 最 理想 的 。 当 然 ， 这 也 是 一 个 仁者 见 仁 、 智 者 见 智 的 问 
题 ， 不 可 能 有 一 个 终极 的 理想 答案 。 


对 于 Go 语言 ， 我 们 采用 不 同 的 处 理 方 法 : 让 机 器 义理 绝 大 部 分 的 格式 化 工作 。 工 具 
程序 gofmt 可 以 根据 需要 将 Go 代码 格式 自动 格式 化 为 统一 的 风格 。 如 果 你 想 了 解 格 
式 化 后 代码 的 缩 进 方式 ， 你 可 以 直接 运行 gofmt， 然 后 查看 输出 结果 。 


下 面 是 一 个 例子 ， 我 们 没有 必要 花 时 间 手 工 调整 类 型 中 成 员 注 释 的 对 齐 方式 。 
Gofmt 可 以 自动 将 注释 对 齐 。 下 面 是 结果 的 定义 : 


type T struct { 
name string // name of the object 
value int // its value 


} 
gofmt 处 理 后 的 结果 : 
type T struct { 
name string // name of the object 
value int // its value 


Go 语言 库 中 的 所 有 代码 都 是 用 gofmt 工 具 格式 化 的 。 

格式 化 的 一 些 细节 : 

缩 进 

我 们 使 用 tab 缩 进 ，gofmt 也 是 默认 用 tab 缩 进 。 当 然 ， 也 可 以 指定 空白 缩 进 。 
行 的 长 度 


Go 语言 代码 每 行 长 度 没有 限制 。 不 用 担心 一 行 的 代码 太 长 超出 显 式 范围 ，gofmt 会 
自动 处 理 太 长 的 行 。 


小 括号 


Go 语言 很 少 使 用 括 弧 : 对 于 控制 结构 (if,for,switch) 括 弧 也 不 是 必须 的 。 而 且 Go 中 
表达 式 中 运算 符 的 优先 级 比较 简洁 ， 例 如 下 面 代码 : 


x&1t;&1t;8 + y&lt;&1t;16 


意思 是 x 和 y 移 位 后 相 加 。 


Go 中 文 文档 


5.2. 格式 化 
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5.3. 注释 


Go 支持 C 语 言 风格 的 /* */ 块 注释 ， 也 支持 C 十 十 风格 的 // 行 注 释 。 当然 ， 行 
注释 更 通用 ， 块 注释 主要 用 于 针对 包 的 详细 说 明 或 者 屏 敬 大 块 的 代码 。 


程序 - 也 是 网 页 服务 器 - godoc 处 理 Go 的 源 代码 ， 从 中 提取 包 的 文档 。 顶 层 声 明 
前 的 注解 ， 如 无 空 行 相隔 ， 和 声明 一 起 提取 作为 条 目的 解释 文字 。 这 些 注解 的 性 质 
和 风格 决定 着 godoc 产生 的 文档 的 质量 。 


每 个 包 都 应 有 一 个 包 注 解 ， 即 package 前 的 块 注解 。 对 多 个 文件 的 包 ， 包 注解 只 需 
出 现在 一 个 文件 中 ， 随 便 哪个 。 包 注解 应 该 介绍 此 包 ， 并 作为 一 个 整体 提供 此 包 的 
对 应 信息 。 它 首先 出 现在 godoc 页 面 ， 来 安排 好 后 续 的 详细 文档 


Vas 
The regexp package implements a simple library for 
regular expressions. 


The syntax of the regular expressions accepted is: 


regexp: 
concatenation { '|' concatenation } 
concatenation: 
{ closure } 
closure: 
term [ *1 | TET UDA ] 
term: 


character 
'[' [ 'A' ] character-ranges ']' 
'(' regexp ')' 

2 

package regexp 


包 如 果 简 单 ， 注 释 可 以 简短 。 


// The path package implements utility routines for 
// manipulating slash-separated filename paths. 


注解 不 需 多 余 排 版 如 星星 横幅 等 。 生 成 的 结果 呈现 时 可 能 不 是 等 宽 字 体 ， 所 以 不 要 
靠 空格 对 齐 ， godoc， 类 似 gofmt 照管 这 些 。 最 后 ， 注 解 是 不 加 解释 的 文本 ， 
HTML 和 其 他 例如 this 会 原样 照搬 ， 所 以 点 避免 使 用 。 


在 包 里 ， 紧 跟 顶 层 声明 前 的 注解 作为 此 声明 的 文 注解 ， 程 序 中 每 个 导出 (AS) 的 
名 字 都 应 该 有 文 注解 。 


文 注解 最 好 是 完整 的 句子 。 首 名 应 该 以 声明 的 名 字 开 始 的 一 句 话 的 总 结 。 


// Compile parses a regular expression and returns, if successfu- 
// object that can be used to match against text. 
func Compile(str string) (regexp *Regexp, error os.Error) { 











Go 的 声明 句法 允许 编组 。 单 一 的 文 注 解 可 以 引出 一 组 相 联 的 常量 或 变量 。 因 为 整 
组 声明 一 起 展现 ， 注 解 可 以 很 粗略 : 


// Error codes returned by failures to parse an expression. 


var ( 
Errinternal = os.NewError("internal error") 
ErrUnmatchedLpar = os.NewError("unmatched '('") 
ErrUnmatchedRpar = os.NewError("unmatched ')'") 
) 


对 于 私有 名 称 ， 编 组 也 可 以 指出 它们 之 间 的 联系 ， 例 如 一 系列 的 变量 由 一 个 互 斥 保 
Fo 


var ( 
countLock sync .Mutex 
inputCount uint32 
outputCount uint32 
errorCount uint32 


5.4. 命名 


名 称 在 Go 里 和 在 其 它 语 言 里 一 样 重 要 。 某 种 情况 下 它们 甚至 有 语义 效果 : 例如 ， 
一 个 名 称 能 否 在 包 外 可 见 取决 于 它 的 第 一 个 字母 是 否 大 写 。 所 以 值得 花 点 时 间 探 讨 
下 Go 程序 的 命名 约定 : 


5.4.1. 包 的 命名 
当 包 引入 时 ， 包 名 成 为 其 内 容 的 引导 符 。 


import "bytes" 


后 ， 导入 者 可 以 讲 bytes.Buffer。 更 有 用 的 是 每 个 包 的 用 户 都 能 使 用 相同 的 名 称 指 
出 它 的 内 容 ， 亦 即 包 应 有 个 好 名 称 : 短 ， 精 ， 好 记 。 习 惯 上 包 名 是 小 写 的 单字 的 名 
称 ; 应 无 必要 用 下 划 线 或 大 小 混 写 。 简 错 不 纠 ， 因 为 你 的 包 的 每 个 用 户 都 要 敲 这 个 
名 字 。 还 有 不 要 无 谓 烦 扰 撞 名 。 包 名 只 是 引入 时 的 默认 名 ; 它 不 需 在 所 有 源码 中 都 
唯一 ， 如 出 现 少见 的 撞 名 ， 导 和 人 者 可 以 给 出 不 同 的 名 字 局 部 使 用 。 无 论 如 何 ， 撞 名 
很 少见 ， 因 为 import 用 的 文件 名 只 决定 使 用 那个 包 。 


另 一 个 习惯 是 包 名 是 源 目录 的 基 名 ; src/pkg/container/vector 里 的 包 引 入 为 
“container/vector” 但 包 名 是 vector， 不 是 container_vector HAZ 
containerVector。 


导入 者 使 用 包 名 引导 其 内 容 (import. 的 记 法 主要 特意 用 在 测试 或 其 它 不 寻常 的 场 
合 ) ， 所 以 包 的 导出 的 名 称 可 据 此 避免 结 结巴 巴 。 例 如 ，bu?o 包 的 buffered 
reader U} Reader， 不 叫 BufReader， 因 为 用 户 看 到 的 是 bu?o.Reader 这 个 清楚 简 
短 的 名 称 。 再 有 ， 因 为 导入 项 总 是 给 出 其 包 名 ，bu?o.Reader 不 会 和 io.Reader 撞 
名 。 类 似 的 ， 用 来 生成 ring.Ring KZ 一 即 Go 的 架构 函数 一 通常 会 被 称 为 
NewRing， 但 因为 Ring 是 此 包 唯 一 的 导出 类 型 ， 并 且 既 然 包 名 叫 ring， 它 就 叫 
New。 此 包 的 客户 看 到 的 是 ring.New。 使 用 包 结 构 帮 你 来 选 个 好 名 。 


Another short example is once.Do; once.Do(setup) reads well and would not be 
improved by writing once.DoOrWaitUntilDone(setup). Long names don't 
automatically make things more readable. If the name represents something 
intricate or subtle, it's usually better to write a helpful doc comment than to attempt 
to put all the information into the name. 


5.4.2. 接口 的 命名 


习惯 上 ， 单 一 成 员 的 界面 的 名 称 是 其 成 员 名 加 -er : Reader, Writer, Formatter 等 。 


存在 这 样 的 一 些 名 称 ， 尊 重 它们 和 它们 所 指 的 函数 会 工作 的 更 好 。Read, Write, 
Close, Flush, String 等 保有 正统 的 签名 和 意义 。 为 了 避免 混淆 ， 除非 有 同样 的 签名 
和 意义 ， 不 要 给 你 的 方法 这 些 名 字 。 同 理 ， 如 果 你 的 方法 实现 了 和 这 些 著名 方法 同 
样 的 意图 ， 给 它 同 样 的 名 称 和 签名 ; 叫 你 的 字符 转换 器 String 而 不 是 ToString。 


5.4.3. 大 小 写 混 和 


最 后 ，Go 习惯 使 用 MixedCaps 和 mixedCaps， 而 不 是 下 划 线 来 宇多 字 的 名 称 。 


5.5. 分 号 


Go 语言 与 C 一 样 都 是 采用 分 号 来 结束 一 条 语句 ， 不 一 样 的 是 ， 并 不 是 所 有 的 源码 都 
要 使 用 分 号 。Go 是 采用 语法 解析 器 自动 在 每 行 末 增加 分 号 ， 所 有 你 在 写 代 码 的 时 
候 可 以 把 分 号 缩 略 . 

这 个 规则 是 : 如 果 一 个 标记 (token) 的 前 一 行 是 标识 符 (identifier)( 就 像 "int" 或 
"float64"), 比如 : 数字 ， 一 个 字符 串 或 一 个 标记 . 


break continue fallthrough return ++ -- ) } 


那么 语法 解析 器 就 会 在 标记 的 后 面 插入 分 号 ， 也 就 是 说 "在 标记 的 后 面 是 个 换行 ， 这 
说 明 可 能 是 语句 的 结束 ， 就 增加 一 个 分 号 "。 


在 右 括号 之 前 可 以 省 略 分 号 ， 上 比如 : 


go func() { for { dst <- <-src } }() 


不 需要 分 号 。 在 Go 编程 中 只 有 几 个 地 方 需要 增加 分 号 ， 比如 : fortes 为 了 把 初始 
化 ， 条 件 和 通 历 元 素 分 开 。 还 有 在 一 行 中 有 多 条 语句 ， 也 需要 增加 分 号 。 

需要 注意 的 是 ， 你 不 能 把 控制 语句 (if, for, switch, or select) 左 大 括号 单独 方 在 一 
行 ， i i A RESIS MARY SIM, 
要 写成 : 


Tipe hee 
g() 


不 要 写成 


if i < f() // wrong! 
{ // wrong! 


g() 


5.6. 控制 流 


Go 语言 的 控制 结构 与 C 的 基本 相同 但 是 有 些 地 方 还 是 不 同 。Go 中 没有 do， while 这 
样 的 循环 ，for 与 switch 也 非常 的 灵活 。if 和 switch 可 以 有 一 个 初始 化 语句 就 像 for 一 
样 。 还 增加 了 一 个 type switch( 类 型 选择 ) 和 多 通道 复 用 (multiway communications 


multiplexer) 的 select. 语法 有 一 点 点 区 别 ， 圆 括号 大 部 分 是 不 需要 的 但 是 大 括号 必 
须 始 终 括号 分 隔 . 
5.6.1. If 
Go 中 简单 的 if 实例 : 
ifx>o{ 
return y 
} 


建议 在 写 放 语句 的 时 候 采 用 多 行 。 这 是 一 种 非常 好 的 编程 风格 ， 特别 是 在 控制 结构 
体 里 面 有 return 或 break 的 时 候 . 


if 和 和 switch 允许 初始 化 声明 ， 就 可 以 使 用 本 地 变量 (local variable). 


if err := file.Chmod(0664); err != nil { 
log.Stderr(err) 
return err 


在 Go 的 库 文件 中 ， 你 可 能 经 常 看 到 if 语句 不 进入 下 一 条 语句 是 因为 函数 在 
break,continue,goto 或 reurn 结 束 , else 可 以 省 略 。 


f, err := os.Open(name, os.O_RDONLY, 0) 
if err != nil { 
return err 


} 
codeUsing(f) 


一 般 的 代码 都 会 考虑 错 误 的 处 理 ， 如 果 没有 出 错 的 情况 就 继续 运行 但 是 在 出 错 的 时 
候 KAARE, PAE ET a else a, 


f, err := os.Open(name, os.O_RDONLY, 0) 
if err != nil { 
return err 


, err := f.Stat() 
if err != nil { 
return err 


codeUsing(f, d) 


5.6.2. For 


Go 中 的 for 循 环 与 C 相 似 ， 但 是 也 有 不 同 的 地 方 。Go 只 有 for 和 while, 没有 do-while 
语句 。 这 里 有 三 种 方式 ， 只 有 一 种 方式 使 用 了 分 号 。 


// Like a C for 
for init; condition; post { } 


// Like a C while 
for condition { } 


// Like a C for(;;) 
for { } 


豆 声 明 使 得 在 循环 里 声明 下 标 变量 很 容易 。 


如 果 你 要 通 历 一 个 array, slice, string or map or 从 通道 (channel) 读 数 range 将 是 你 
最 好 的 选择 。 


var m map[string]int 

sum := 0 

for _, value := range m { // key is unused 
sum += value 

} 


对 于 字符 串 ，range 能 为 你 更 好 的 工作 ， 上 比如 解析 UTF-8 并 单独 输出 Unicode 字 符 . 


for pos, char := range "日 本 语 " { 
fmt.Printf("character %c starts at byte position %d\n", char, 


} 





‘| 
打印 出 : 





character 日 starts at byte position 0 
character A starts at byte position 3 
character 语 starts at byte position 6 


最 后 ，Go 中 没有 逗号 运算 符 (comma operator) 和 ++ 和 与 -- 运 算 ， 如 果 你 想 执 行 多 个 变 
量 在 for 语 句 中 ， 你 可 以 使 用 并 行 参 数 (parallel assignment). 


// Reverse a 
for i, j := 0, len(a)-1; i < j; i, j = i+1, j-1 { 
a[i], a[j] = a[j], a[i] 


5.6.3. Switch 
Go 中 的 switch 要 比 C 更 全 面 ，C 的 表达 式 仅 仅 只 有 常数 或 整数 。 每 个 分 支 (cases) 从 


上 到 下 进行 匹配 取 值 , 如 果 switch 没 有 表达 式 那么 switches 是 真 。 所 有 才 有 可 能 使 
用 switch 蔡 换 


func unhex(c byte) byte { 


switch { 

case '0' <= c &&c <= '9': 
return c - '0' 

case 'a' <=c &&c <= 'f': 
return c - 'a' + 10 

case 'A' <= c &&c <= 'F': 
return c - 'A' + 10 

} 

return 0 


没有 自动 掉 到 下 一 分 支 ， 但 分 支 可 以 是 至 号 分 隔 的 列表 : 


func shouldEscape(c byte) bool { 
switch c { 
case 1 ie Benes '&', = '#', ae Lozi 
return true 


return false 


这 个 操作 数组 的 程序 和 上 面 的 相似 是 通过 两 个 switch 语 句 。 


// Compare returns an integer comparing the two byte arrays 
// lexicographically. 
// The result will be 0 if a == b, -1 if a < b, and +1 if a> b 
func Compare(a, b []byte) int { 
for i := 0; i < len(a) && i < len(b); i++ { 
switch { 
case a[i] > b[i]: 
return 1 
case a[i] < b[i]: 
return -1 
} 


switch { 

case len(a) < len(b): 
return -1 

case len(a) > len(b): 
return 1 

} 


return 0 


Eee 
switch 可 以 动态 的 取得 接口 变量 的 数据 类 型 ， 比 如 : type switch 就 是 用 关键 字 type 


插入 到 接口 类 型 后 面 的 括号 来 判断 类 型 ， 如 果 switch 在 表达 式 中 声明 了 一 个 变量 ， 
在 分 文 上 就 有 相应 的 类 型 。 


switch t := interfaceValue.(type) { 


default: 

fmt.Printf("unexpected type %T", t) // %T prints type 
case bool: 

fmt.Printf("boolean %t\n", t) 
case int: 


fmt .Printf("integer %d\n", t) 
case *bool: 

fmt.Printf("pointer to boolean %t\n", *t) 
case *int: 

fmt.Printf ("pointer to integer %d\n", *t) 
} 
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5.7. HX 


5.7.1. 2168 E] 


Go 语言 中 图 ee 个 有 意思 的 特性 是 它们 可 以 同时 返回 多 个 值 。 它 可 以 
比 C 语 言 更 简洁 的 处 理 多 个 返回 值 的 情况 : 例如 在 修改 一 个 参数 的 同时 获取 错误 返 
回 值 〈-1 或 EOF) 。 


在 传统 的 C 语 言 中 ， 如 果 写 数据 失败 的 话 ， .会 在 另外 一 个 地 方 保存 错误 标志 ， 而 且 
错误 标志 很 容易 被 其 他 函数 产生 的 错误 覆盖 。 在 Go 语言 中 ， 则 可 以 在 返回 成 功 写 
入 的 数据 数目 的 同时 ， 也 可 以 返回 有 意义 的 错误 信息 : :“ 您 已 经 写 了 一 些 数据 ， 但 
不 是 全 部 ， 因 为 设备 在 阻塞 填充 中 ”对 于 os 包 中 的 *File.Write 函 数 ， 说 明 如 下 : 


func (file *File) Write(b []byte) (n int, err Error) 


NAA SANSOM : 返回 成 功 写 人 的 数据 长 度 ， 如 果 n != 
len(b)， 则 同时 返回 一 个 非 non-nil 的 错误 信息 。 这 是 Go 语言 中 ， 处 理 错误 的 常见 方 
式 。 在 后 面 的 “错误 义理 "一 节 ， 会 有 更 多 的 描述 。 


多 个 返回 值 还 可 以 用 于 模拟 C 语 言 中 通过 指针 的 方式 通 历 。 下 面 的 范 数 是 从 一 个 int 
数组 中 获取 一 个 数据 ， 然 后 移动 到 下 一 个 位 置 。 


func nextInt(b []byte, i int) (int, int) { 
for ; i < len(b) && !isDigit(b[i]); i++ { 
x := 0 
for ; i < len(b) && isDigit(b[i]); i++ { 
x = x*10 + int(b[i])-'0' 


return x, i 


你 还 可 以 用 这 个 方法 来 打印 一 个 数组 : 


for i := 0; i < len(a); { 
x, i = nextInt(a, i) 
fmt.Println(x) 


5.7.2. 命名 的 结果 参数 


Goz gt, RiNRTIAAWARALH REEMA, MIRRA AAA. A0 
果 我 们 命名 了 返回 值 ， 那么 它们 将 在 函数 开始 的 时 候 被 初始 化 为 空 。 然 后 ， 在 执行 
不 带 参 数 的 return 语 句 时 ， 命名 的 返回 值 变量 将 被 用 于 返回 。 


返回 值 命名 并 不 强制 使 用 ， 但 是 有 时 我 们 给 名 返回 值 命 售 可 以 产生 更 清晰 的 代码 ， 
同时 它 也 可 以 用 于 文档 。 例如 ， 我 们 把 nextlnt 的 返回 值 命名 : 


func nextInt(b []byte, pos int) (value, nextPos int) { 


命名 后 ， 返 回 值 会 自动 初始 化 ， 而 且 不 需要 在 return 中 显 式 写 出 返回 参数 。 下 面 的 
io.ReadFull 函数 是 另 一 个 类 似 的 例子 : 


func ReadFull(r Reader, buf []byte) (n int, err os.Error) { 
for len(buf) > © && err == nil { 
var nr int 
nr, err = r.Read(buf ) 
n += nr 
buf = buf[nr:len(buf) ] 


return 


5.7.3. Defer 


Go 的 defer 语句 安排 一 个 画 数 调用 (被 defer 的 函数 ) 延迟 发 生 在 执行 defer MH 
数 刚 要 返回 之 前 。 当 函数 无 论 怎样 返回 ， 某 资源 必须 释放 时 ， 可 用 这 种 与 众 不 同 、 
但 有 效 的 义理 方式 。 传 统 的 例子 包括 解锁 互 斥 或 关闭 文件 。 


// Contents returns the file's contents as a string. 
func Contents(filename string) (string, os.Error) { 
f, err := os.Open(filename, os.O_RDONLY, 0) 

if err != nil { 
return "", err 


defer f.Close() // f.Close will run when we're finished. 


var result []byte 
buf := make([]byte, 100) 
for { 
n, err := f.Read(buf[0: ]) 
result = append(result, buf[O:n]...) // append is discus: 


if err != nil { 
if err == os.EOF { 
break 
} 
return "", err // f will be closed if we return here 


} 
} 


return string(result), nil // f will be closed if we return ł 





十 ëg 


这 样 延迟 一 个 图 数 有 双重 优势 : —EMKARAMIZAM MA, RREME A 
E E 
清晰 很 多 。 


JER EMSS (包括 接受 者 ， 如 果 阔 数 是 一 个 方法 ) 的 求 值 发 生 在 defer 语句 执 
行 时 ， 而 不 是 延迟 函数 调用 时 。 除 了 不 必 担 心 函 数 执行 时 变量 值 的 改变 外 ， 也 意味 
着 同一 延迟 调用 可 以 延迟 多 个 函数 的 执行 。 如 下 傻 例 : 


for i := 07 i < 5; i++ { 
defer fmt.Printf("%d ", i) 
} 


延迟 豆 数 执行 顺序 为 LIEO， 所 以 上 面 代 码 在 函数 返回 时 打印 4 3 2 1 0。 更 可 信 的 
例子 是 跟踪 程序 中 男 数 执行 的 一 个 简单 方式 。 我 们 可 以 写 些 简单 的 跟踪 例 程 : 


func trace(s string) { fmt.Println("entering:", s) } 
func untrace(s string) { fmt.Println("leaving:", s) } 


// Use them like this: 
func a() { 
trace("a") 
defer untrace("a") 
// do something.... 


i 函数 的 参量 在 defer tI Sahm, REKA A LASC HEAR ER ERE BL 
的 参量 。 


func trace(s string) string { 
fmt .Printin("entering:", s) 
return S 


} 


func un(s string) { 
fmt.Println("leaving:", s) 
} 


func a() { 
defer un(trace("a")) 
fmt.Println("in a") 


} 


func b() { 
defer un(trace("b")) 
fmt.Println("in b") 
a() 


func main() { 


b() 
} 
打印 : 
entering: b 
in b 
entering: a 
ina 


leaving: a 
leaving: b 


对 于 习惯 其 它 语言 的 块 层次 资源 管理 的 程序 员 ，defer 可 能 比较 怪 ， 但 它 最 有 趣 最 
ee RESE 在 panic 和 recover 一 节 我 们 
会 看 到 一 个 例子 


5.8. 数据 


5.8.1. new() 分 配 


Go 有 两 个 分 配 原 语 ，new() 和 make() 。 它 们 做 法 不 同 ， 也 用 作 不 同类 型 上 。 有 点 
乱 但 规则 简单 。 我 们 先 谈 谈 new() 。 它 是 个 内 部 函数 ， 本 质 上 和 其 它 语 言 的 同类 一 
样 : new(T) 分 配 一 块 清 震 的 存储 空间 给 类 型 二 的 新 项 并 返回 其 地 址 ， 一 个 类 型 *T 
的 值 。 用 Go 的 术语 ， 它 返回 一 个 类 型 的 新 分 配 的 需 值 。 


因为 new() 返回 的 内 存 清 需 ， 可 以 用 来 安排 使 用 雳 值 的 物件 而 不 需 再 初始 化 。 亦 即 
数据 结构 的 用 户 可 以 直接 用 new() 生成 一 个 并 马上 使 用 。 例 如 ， bytes.Buffer 的 文 
HESA Buffer 为 空 并 可 用 ”。 同 http://code.google.com/p/ac-me/ 61 理 ， 
sync.Mutex 没有 明确 的 架构 函数 或 init 方法 。 而 是 ， 一 个 sync.Mutex 的 需 值 定义 
为 开锁 的 互 斥 。 


雳 值 有 用 ， 这 个 特性 可 以 顺延 。 考 虑 下 面 的 声明 。 


type SyncedBuffer struct { 
lock sync .Mutex 
buffer bytes.Buffer 


类 型 SyncBuffer 的 值 在 分 配 或 者 声明 后 立即 可 用 。 下 例 ，p 和 v 无 需 多 余 的 安排 已 
可 以 正确 使 用 了 。 


p := new(SyncedBuffer) // type *SyncedBuffer 
var v SyncedBuffer // type SyncedBuffer 


5.8.2. 构造 和 结构 初始 化 
有 时 需 值 不 够 好 ， 有 必要 使 用 一 个 初始 化 架构 函数 ， 如 下 面 从 os 包 引 出 的 例子 。 


func NewFile(fd int, name string) *File { 
if fd< © { 
return nil 


} 

f := new(File) 
f.fd = fd 
f.name = name 
f.dirinfo = nil 
f.nepipe = 0 
return f 


Ts 我 们 可 用 组 合 字面 简化 之 ， 它 是 个 每 次 求 值 即 生成 新 实例 的 表达 
工 vo 


func NewFile(fd int, name string) *File { 
if td <6 { 
return nil 


} 
f := File{fd, name, nil, 0} 
return &f 


注意 返回 局 部 变量 的 地 址 是 完全 OK 的 ; 变量 对 应 的 存储 空间 在 事 数 返回 后 仍然 存 
在 。 实 际 上 ， 取 一 个 组 合 字 面 的 地 址 使 每 次 它 求 值 时 都 生成 一 个 新 实例 ， 因 此 我 们 
可 以 把 最 后 两 行 合 起 来 。 


return &File{fd, name, nil, 0} 


组 合 字面 的 域 必 须 按 顺 序 给 出 并 全 部 出 现 。 可 是 ， 明 确 的 用 域 : 值 对 儿 标 记 元 素 ， 初 
始 化 可 用 任意 顺序 ， 未 出 现 的 对 应 着 需 值 。 所 以 我 们 可 以 讲 


return &File{fd: fd, name: name} 


特别 的 ， 如 果 一 个 组 合 字面 一 个 域 也 没有 ， 它 生成 此 类 型 的 需 值 。 表 达 式 new(File) 
和 &File{} 是 等 价 的 。 


组 合 字 面 也 可 以 生成 数组 、 切 片 和 映射， 其 域 为 合适 的 下 标 或 映射 键 。 下 例 中 ， 无 
论 Enone Eio 和 Einval 是 什么 值 都 可 以 ， 只 要 它们 是 不 同 的 。 


a := [...]string {Enone: "no error", Eio: "Eio", Einval: "inva: 
s := []string {Enone: "no error", Eio: "Eio", Einval: "inva: 
m := map[int]string{Enone: "no error", Eio: "Eio", Einval: "inva: 


-| ëO 





5.8.3. make() 分 配 


EAS. ABBE make(T, args) 的 服务 目的 和 new(T) 不 同 。 它 只 生成 切片 ， 映 
射 和 信道 ， 并 返回 一 个 初始 化 的 (不 是 需 ) 的 ，type T 的 ， 不 是 *T 的 值 。 这 种 区 分 
的 原因 是 ， 这 三 种 类 型 ， 揭 开 盖 子 ， 底 下 引用 的 数据 结构 必须 在 用 前 初始 化 。 比 如 
切片 是 一 个 三 项 的 描述 符 ， 包 含 数据 指针 (数组 内 ) ， 长 度 ， 和 容量 ; 在 这 些 项 初 
始 化 前 ， 切 片 为 nil 。 对 于 切片 、 映 射 和 信道 ，make 初始 化 内 部 数据 结构 ， 并 准备 
要 用 的 值 。 例 如 ， 


make([]int, 10, 100) 


分 配 一 个 100 个 整数 的 数组 ， 然 后 生成 一 个 切片 结构 ， 长 度 为 10， 容 量 是 100 的 指 
向 此 数组 的 首 10 项 。 (生成 切片 时 ， 容 量 可 以 不 写 ; 详 见 切片 一 节 。) 对 应 的 ， 
new([int) 返回 一 个 新 分 配 的 ， 清 需 的 切片 结构 ， 亦 即 ， 一 个 nil 切片 值 的 指针 。 


下 面 的 例子 展示 了 new() 和 make() 的 不 同 。 


new([]int) // allocates slice structure; *p 
make([]int, 100) // v now refers to a new array ol 


var p *[]int = 
var v []int = 
// Unnecessarily complex: 
var p *[]int = new([]int) 
*p = make([]int, 100, 100) 


// Idiomatic: 
v := make([]int, 100) 


EIE U 


记 住 make() 只 用 于 映射 、 切 片 和 信道 ， 不 返回 指针 。 要 明确 的 得 到 指针 用 new() 
分 配 。 





5.8.4. 数组 


数组 用 于 安排 详细 的 内 存 布局 ， 还 有 助 于 避免 分 配 ， 但 其 主要 作为 切片 的 构件 ， 即 
下 节 的 主题 。 这 里 先 讲 几 句 打 个 底 儿 。 


Go 和 C 的 数组 的 主要 不 同 在 于 : 

o 数组 为 值 。 数 组 赋值 给 另 一 数组 拷贝 其 全 部 元 素 。 

e 特别 是 ， 如 果 你 传递 数组 给 一 个 函数 ， 它 受到 此 数组 的 拷贝 ， 不 是 指针 。 

eo 数组 的 尺寸 是 其 类 型 的 一 部 分 。[10]int 和 [20]int 是 完全 不 同 的 类 型 。 
I ; 如 你 所 需 的 是 类 似 C 的 行为 和 效率 ， 你 可 以 传递 一 个 指针 给 
数组 。 


func Sum(a *[3]float) (sum float) { 


for _, v := range *a { 
sum += v 
return 
} 
array := [...]float{7.0, 8.5, 9.1} 
x := Sum(&array) // Note the explicit address-of operator 


即便 如 此 也 不 是 地 道 的 Go 风格 。 切 片 才 是 。 


5.8.5. Slices 切片 


切片 包装 数组 ， 给 数据 系列 一 个 通用 、 强 力 、 方 便 的 界面 。 除 了 像 变 换 矩 阵 那 种 要 
求 明 确 尺 寸 的 情况 ， 绝 大 部 分 的 数组 编程 在 Go 里 使 用 切片 、 而 不 是 简单 的 数组 。 


切片 是 引用 类 型 ， 即 如 果 赋 值 切片 给 另 一 个 切片 ， 它 们 都 指向 同一 底层 数组 。 例 
如 ， 如 果 某 画 数 取 切 片 参 量 ， 对 其 元 素 的 改动 会 显现 在 调用 者 中 ， 类 似 于 传递 一 个 
底层 数组 的 指针 。 因 此 Read 函数 可 以 接受 切片 参量 ， 而 不 需 指 针 和 计数 ; 切片 的 
长 度 决定 了 可 读数 据 的 上 限 。 这 里 是 os 包 的 File 型 的 Read 方法 的 签名 : 


func (file *File) Read(buf []byte) (n int, err os.Error) 


此 方法 返回 读 人 字 节 数 和 可 能 的 错误 值 。 要 读 人 一 个 大 的 缓冲 b 的 首 32 字 节 ， DW 
片 (动词 ) 缓冲 。 


n, err := f.Read(buf[0:32]) 


这 种 切片 常用 且 高 效 。 实 际 上 ， 先 不 管 效率 ， 此 片段 也 可 读 缓 冲 的 首 32 字 节 。 


var n int 
var err os.Error 
ROR SO seo 2 eet 
nbytes, e := f.Read(buf[i:i+1]) // Read one byte. 
if nbytes == 0 || e != nil { 
err =e 
break 


} 


n += nbytes 


只 要 还 在 底层 数组 的 限制 内 ， 切 片 的 长 度 可 以 改变 ， 只 需 赋 值 自 己 。 切 片 的 容量 ， 
A AASB cap 取得 ， 给 出 此 切片 可 用 的 最 大 长 度 。 下 面 的 函数 给 切片 添 值 。 如 
果 数 据 超过 容量 ， 切 片 重 新 分 配 ， 返 回 结果 切片 。 此 画 数 利用 了 len 和 cap 对 nil 
切片 合法 、 返 回 0 的 事实 。 


func Append(slice, data[]byte) []byte { 

l := len(slice) 

if 1 + len(data) > cap(slice) { // reallocate 
// Allocate double what's needed, for future growth. 
newSlice := make([]byte, (1+len(data))*2) 
// Copy data (could use bytes.Copy()). 
for i, c := range slice { 

newSlice[i] = c 

} 


slice = newSlice 


slice = slice[0:1+len(data) ] 

for i, c := range data { 
slice[l+i] = c 

} 


return slice 


我 们 必须 返回 切片 ， 因 为 尽管 Append 可 以 改变 slice 的 元 素 ， 切片 自身 (FAB 
针 、 长 度 和 容量 的 运行 态 数据 结构 ) 是 值 传 递 的 。 添 加 切片 的 主意 很 有 用 ， 因 此 由 
ATA append 实现 。 要 理解 此 本 数 的 设计 ， 我 们 需要 多 一 些 信息 ， 所 以 稍 后 再 
讲 。 


5.8.6. Maps 字典 


映射 提供 了 一 个 方便 强力 的 内 部 数据 结构 ， 用 来 联合 不 同 的 类 型 。 键 可 以 是 任何 定 
义 了 相等 操作 符 的 类 型 ， 如 整 型 ， 浮 点 型 ， 字 捉 ， 指 针 ， 界 面 (只 要 其 动态 类 型 文 
持 相等 ) 。 结 构 ， 数 组 和 切片 不 可 用 作 映 射 键 ， 因 为 其 类 型 未 定义 相等 。 类 似 切 

片 ， 映 射 是 引用 类 型 。 如 果 你 传递 映射 给 某 画 数 ， 对 映射 的 内 容 的 改动 显现 给 调用 


o 


映射 的 生成 使 用 平常 的 冒号 隔 开 的 键 值 伴 组 合 字面 句法 ， 所 以 很 容易 初始 化 时 建 好 


它们 。 


var timeZone = map[string] int { 
"UTC": 0*60*60, 
"EST": -5*60*60, 
"CST": -6*60*60, 
"MST": -7*60*60, 
"PST": -8*60*60, 


赋值 和 获取 映射 值 语法 上 就 像 数组 ， 只 是 下 标 不 需 是 整 型 。 


offset := timeZone["EST"] 


试图 获取 不 存在 的 键 的 映射 值 返回 对 应 条 目 类 型 的 需 值 。 例 如 ， 如 果 映 射 包 含 整 型 
数 ， 查 找 不 存在 的 键 返回 0。 


有 时 你 需 区 分 不 在 键 和 零 值 。 是 没有 “UTC” 的 条 目 ， 还 是 因为 其 值 为 霉 ? 你 可 以 
用 多 值 赋值 的 形式 加 以 区 分 。 


var seconds int 
var ok bool 
seconds, ok = timeZone[tz] 


SRA E, WbAiSM ASB Sok”. WPI, WR tz HE, seconds 相应 赋值 ，ok 
AB; BM, seconds 为 0，ok 为 假 。 下 面 的 函数 加 上 了 中 意 的 出 错 报告 : 


func offset(tz string) int { 
if seconds, ok := timeZone[tz]; ok { 
return seconds 


log.Stderr("unknown time zone", tz) 
return 0 


要 检查 映射 的 存在 ， 又 不 想 管 实际 值 ， 你 可 以 用 空白 标识 ， 即 下 划 线 (_). ZA 
标识 可 以 赋值 或 声明 为 任意 类 型 的 任意 值 ， 会 被 无 害 的 丢弃 。 如 只 要 测试 映射 是 否 
存在 ， 在 平常 变量 的 地 方 使 用 空白 标识 即 可 。 


_, present := timeZone[tz] 


要 删除 映射 条 目 ， 翻 转 多 值 赋值 ， 在 右边 多 放 个 布尔 ; 如 果 布 尔 为 假 ， 条 目 被 删 。 
即便 键 已 经 不 再 了 ， 这 样 做 也 是 安全 的 。 


timeZone["PDT"] = ©, false // Now on Standard Time 


5.8.7. 打印 


Go 的 排版 打印 风格 类 似 C 的 printf 族 但 更 丰富 更 通用 。 这 些 范 数 活 在 fmt BE, 
叫 大 写 的 名 字 : fmt.Printf，fmt.Fprintf， fmt.Sprintf 等 等 。 字 串 函 数 (Sprintf 等 ) 
返回 字 串 ， 而 不 是 填充 给 定 的 缓冲 。 


你 不 需 给 出 排版 字 串 。 对 应 每 个 Printf，Fprintf 和 Sprintf 都 有 另 一 对 函数 。 例 如 
Print 和 Printin, 它们 不 需 排版 字 串 ， 而 是 用 每 个 参量 默认 的 格式 。Println 版 本 还 
会 在 参量 间 加 入 空格 和 输出 新 行 ， 而 Print 版 本 只 当 操 作 数 的 两 边 都 不 是 字 串 时 才 
添加 空格 。 下 例 每 行 的 输出 都 是 一 样 的 : 


fmt.Printf("Hello %d\n", 23) 
fmt.Fprint(os.Stdout, "Hello ", 23, "\n") 
fmt.Println(fmt.Sprint("Hello ", 23)) 


如 《辅导 》 里 所 讲 ，fmt.Fprint 和 伙伴 们 的 第 一 个 参量 可 以 是 任何 实现 io.Writer A 
面 的 物件 。 变量 os.Stdout 和 os.Stderr 是 熟悉 的 实例 。 


从 此 事情 开始 偏离 C 了 。 首 先 ， 数 字 格 式 如 %d 没有 正 负 和 尺寸 的 标记 ; 打印 例 程 
使 用 参量 的 类 型 决定 这 些 属 性 。 


var x uint64 = 1<<64 - 1 
fmt.Printf("%d %x; %d %x\n", x, x, int64(x), int64(x)) 


打印 出 : 


18446744073709551615 ffffffffffffffff; -1 -1 


如 果 你 只 需 默 认 的 转换 ， 例 如 整数 用 十 进 制 ， 你 可 以 用 全 拿 格式 %v (代表 
value) ; 结果 和 Print 与 Printin 打印 的 完全 一 样 。 再 有 ， 此 格式 可 打印 任意 值 ， 包 
括 数 组 ， 结 构 和 映射。 这 里 是 上 节 定 义 的 时 区 映射 的 打印 语句 。 


fmt.Printf("%v\n", timeZone) // or just fmt.Println(timezZone) 


打印 出 : 


map[CST:-21600 PST:-28800 EST:-18000 UTC:0 MST: -25200] 


当然 ， 映 射 的 键 会 以 任意 顺序 输出 。 打 印 结构 时 ， 改 进 的 格式 %+v 用 结构 的 域名 
注释 ， 对 任意 值 格 式 Hv 打印 出 完整 的 Go 句法 。 


type T struct { 
a int 
b float 
c string 


} 

t := &T{ 7, -2.35, "abc\tdef" } 
fmt.Printf("%v\n", t) 
fmt.Printf("%+v\n", t) 
fmt.Printf("%#v\n", t) 
fmt.Printf("%#v\n", timeZone) 


打印 出 : 


&{7 -2.35 abc def} 

&{a:7 b:-2.35 c:abc def} 

&main.T{a:7, b:-2.35, c:"abc\tdef"} 

map[string] int{"CST":-21600, "PST":-28800, "EST":-18000, "UTC":( 


(注意 和 号 &) 。 引 号 括 起 的 字 串 也 可 以 %q 用 在 string 或 [byte 类 型 的 值 上 ， 对 
应 的 格式 %#q 如 果 可 能 则 使 用 反 引 号 。 还 有 ，%x 可 用 于 字 串 、 字 节 数 组 和 整 型 ， 
得 到 长 的 十 六 进 制 串 ， 有 空格 的 格式 (% x) 会 在 字 节 间 加 空格 。 


另 一 好 用 的 格式 是 %T， 打 印 某 值 的 类 型 。 








fmt.Printf("%T\n", timeZone) 


打印 出 : 


map[string] int 
如 果 你 要 控制 某 定制 类 型 的 默认 格式 ， 只 需 在 其 类 型 上 定义 方法 String() string. 对 
我 们 简单 的 类 型 T， 可 以 是 : 


func (t *T) String() string { 
return fmt.Sprintf("%d/%g/%q", t.a, t.b, t.c) 


fmt.Printf("%v\n", t) 


来 打印 


7/-2.35/"abc\tdef" 


我 们 的 String() 方法 可 以 调用 Sprint， 因 为 打印 例 程 是 完全 可 以 重 入 可 以 递 及 的 。 
我 们 可 以 更 进一步 ， 把 一 个 打印 例 程 的 参量 直接 传递 给 另 一 打印 例 程 。 Printf 的 签 
名 的 首 参 量 使 用 类 型 ...interfacef}， 来 指定 任意 数量 任意 类 型 的 参量 可 以 出 现在 格 
式 字 串 的 后 面 。 


func Printf(format string, v ...) (n int, errno os.Error) { 


Printf HAH, v 像 是 一 个 [jinterfacef} 类 的 变量 。 但 如 果 把 它 传递 给 另 一 个 多 维 罚 
数 ， 它 就 像 一 列 普 通 的 参量 。 这 里 是 我 们 上 面 用 过 的 log.PrintIn 的 实现 。 它 把 自己 
的 参量 直接 传递 给 fmt.Sprintin 来 实际 打印 。 


// Stderr is a helper function for easy logging to stderr. It is 
func Stderr(v ...) 4 
stderr.Output(2, fmt.Sprintln(v)) // Output takes parameter: 


} 
aj — # 


我 们 在 Sprintin 的 调用 的 v 后 写 ... 告诉 编译 器 把 v 作为 一 列 参量 ; 否则 它 只 是 传 
递 一 个 单一 的 切片 参量 。 
还 有 很 多 打印 的 内 容 我 们 还 没 讲 ， 细 节 可 参考 godoc 的 fmt 包 的 文档 。 


顺便 提 一 句 ， … 参量 可 以 是 任意 给 定 的 类 型 ， 例 如 ，...int 在 min 函数 里 可 以 选 一 
列 整数 的 最 小 值 。 








func Min(a ...int) int { 
min := int(Auint(0) >> 1) // largest int 
for _, i := range a { 
if i < min { 
min = i 
} 
} 


return min 


5.8.8. Append 


现在 我 们 解释 append 的 设计 。append 的 签名 和 上 面 我 们 定制 的 Append HAA 
同 。 大 体 上 是 : 


func append(slice []T, elements...T) []T 


T 替代 的 是 任意 实际 中 你 不 能 写 Go 的 函数 由 调用 者 决定 TT 的 类 型 ， 所 以 
append AE : 它 需 要 编译 器 的 支持 。 


append 所 做 的 是 在 切片 尾 添加 元 素 并 返回 结果 。 结 果 需 要 返回 因为 ， 正 如 我 们 手 
写 的 Append， 底 层 的 数组 可 能 更 改 。 下 面 简单 的 例子 


= [Jint{1, 2,3} 
X = append(x, 4, 5, 6) 
fmt .Printlin(x) 


打印 12345。 所 以 append 有 点 像 Printf 收集 任意 数量 的 参量 。 


但 如 何 像 我 们 Append 一 样 给 切片 添加 切片 虽 ? 容易 : 使 用 ... 在 调用 的 地 方 ， 正 如 
我 们 上 面 我 们 调用 Output, 下 例 产 生 如 上 同 祥 的 输出 : 


x := []int{1,2,3} 
y := []int{4,5,6} 
x = append(x, y...) 
fmt.Println(x) 


没有 … 将 不 能 编译 ， 因 为 类 型 错误 ; y 不 是 int 类 型 。 


5.9. 初始 化 


尽管 表面 看 来 和 C 或 C++ 的 初始 化 没什么 不 同 ，Go 的 更 够 强 。 复 条 结构 可 在 初始 
化 时 架设 ， 并 且 不 同 包 的 物件 的 初始 化 顺序 问题 也 得 到 正确 处 理 。 


5.9.1. Constants 常量 初始 化 


常量 在 Go 里 是 不 变 的 。 它 们 在 编译 时 生成 ， 即 便 是 局 部 定义 在 本 数 里 。 它 
只 能 是 数 ， 字 串 或 布尔 。 因 为 编译 态 的 限制 ， 定 义 它 们 的 表达 式 必须 是 常量 表达 
式 ， 可 以 被 编译 器 求 值 。 例 如 ，1<<3 是 常量 表达 式 ， math.Sin(math.Pi/4) 不 是 ， 
因为 math.Sin 的 函数 调用 发 生 在 运行 态 。 


Go 的 列举 常量 可 用 iota 生成 。 因为 iota 可 以 是 表达 式 的 一 部 分 ， 并 且 表 达 式 可 以 
隐 含 重复 ， 打 造 一 套 精 致 的 值 可 以 变 得 很 容易 。 





type ByteSize float64 

const ( 
_= iota // ignore first value by assigning to blank identili 
KB ByteSize = 1<<(10*iota) 





给 类 型 添加 比如 String 等 方法 的 本 领 ， 使 值 自动 排版 打印 自己 变 得 可 能 ， 即 使 只 作 
为 通用 类 型 的 一 部 分 。 


func (b ByteSize) String() string { 

switch { 
case b >= YB: 

return fmt.Sprintf("%.2FYB", b/YB) 
case b >= ZB: 

return fmt.Sprintf("%.2FZB", b/ZB) 
case b >= EB: 

return fmt.Sprintf("%.2FEB", b/EB) 
case b >= PB: 

return fmt.Sprintf("%.27PB", b/PB) 
case b >= TB: 

return fmt.Sprintf("%.2fTB", b/TB) 
case b >= GB: 

return fmt.Sprintf("%.2—7GB", b/GB) 
case b >= MB: 

return fmt.Sprintf("%.2—MB", b/MB) 
case b >= KB: 

return fmt.Sprintf("%.2FKB", b/KB) 


} 
return fmt.Sprintf("%.2fB", b) 


表达 式 YB 打印 1.00YB, mi ByteSize(1e13) 打印 9.09TB 


5.9.2. 变量 初始 化 
变量 和 常量 的 初始 化 一 样 ， 但 可 以 用 运行 态 计算 的 普通 表达 式 。 


var ( 
HOME = os.Getenv("HOME") 
USER = os.Getenv("USER" ) 
GOROOT = os.Getenv("GOROOT" ) 


5.9.3. init 辑 数 


最 后 ， 每 个 源 文件 可 以 定义 自身 的 init) 函数 来 安排 所 需 的 状态 。 唯 一 的 限制 是 ， 
尽管 够 程 可 在 初始 化 时 启动 ， 它 们 只 在 初始 完成 后 执行 ; 初始 化 永远 是 单一 的 执行 
序列 。 最 后 之 后 ，init() 发 生 在 包 里 所 有 变量 初始 化 之 后 ， 而 其 又 发 生 在 所 有 的 包 全 
部 导入 之 后 。 


除了 初始 化 不 能 表示 为 声明 外 ，init() 范 数 常用 来 在 程序 运行 前 验证 或 修补 其 状态 。 


func init() { 
if USER ==." 7 
log.Exit("$USER not set") 


if HOME == ney 

HOME = "/usr/" + USER 
} 
if GOROOT == "" { 

GOROOT = HOME + "/go" 
} 


// GOROOT may be overridden by --goroot flag on command line 
flag.StringVar(&GOROOT, "goroot", GOROOT, "Go root directory' 





5.10. 方法 


5.10.1. 指针 vs 值 
方法 可 用 于 任意 带 名 的 非 指 针 和 界面 的 类 型 ; 接受 者 没 必要 是 结构 。 


在 上 面 讨 论 切 片 时 ， 我 们 罕 了 个 Append 函数 。 其 实 我 们 可 以 把 它 定义 为 切片 的 方 
法 。 首 先 我 们 声明 一 个 带 名 的 类 型 ， 以 便 我 们 在 其 上 施加 方法 ， 并 使 此 方法 的 接受 
者 的 值 是 此 类 型 。 


type ByteSlice []byte 


func (slice ByteSlice) Append(data []byte) []byte { 
// Body exactly the same as above 
} 


这 仍 需 方法 返回 更 新 的 切片 ， 更 灵活 的 方式 是 定义 方法 接受 ByteSlice 的 指针 ， 以 
便 重 写 调用 着 的 切片 。 


func (p *ByteSlice) Append(data []byte) { 
slice := *p 
// Body as above, without the return. 
*p = slice 


RTE, RNEER. WARE FBLA Rta HEB Write 方法 ， 例 如 : 


func (p *ByteSlice) Write(data []byte) (n int, err os.Error) { 
slice := *p 
// Again as above. 
*p = slice 
return len(data), nil 


此 时 类 型 *ByteSlice 可 以 满足 标准 界面 io.Writer， 很 方便 的 ， 例 如 我 们 打印 到 里 
A: 


var b ByteSlice 
fmt.Fprintf(&b, "This hour has %d days\n", 7) 


我 们 传递 ByteSlice 的 地 址 是 因为 只 有 *ByteSlice 满足 io.Writer。 接 受 者 的 指针 和 
值 规则 是 ， 值 的 方法 可 用 于 指针 和 值 ， 而 指针 的 方法 只 用 于 指针 。 这 是 因为 指针 方 
法 可 以 改变 接受 者 ; 使 用 拷贝 的 值 会 导致 这 些 改变 的 丢失 。 


顺便 一 提 ， 字 节 切 片 的 Write GE bytes.Buffer 实现 。 


5.11. 接口 和 其 他 类 型 


5.11.1. 接口 


Go 中 的 接口 提供 了 一 类 对 象 的 抽象 。 我 们 在 前 面 已 经 看 到 了 关于 接口 的 一 些 例子 。 
我 们 可 以 给 新 定义 的 对 象 实现 一 个 String 方 法 ， 这 样 就 可 以 用 Fprintf 输 出 该 类 型 的 
值 。 同 样 ，Fprintf 可 以 将 结果 输出 到 任意 实现 了 Write 方法 的 对 象 。 接 口 一 般 只 包 
含 一 类 方法 ， 并 且 以 ed 后 级 的 方式 命名 ， 例 如 io.Writer 接 口 对 应 Wirite 方法 实现 。 


一 种 类 型 可 以 实现 多 个 接口 。 例 如 ， 如 果 想 支持 sort 包 中 的 排序 方法 ， 那 么 只 需 
实现 sort.Interface 接 口 的 Len()、 Less()、Swap(i, j int) 方 法 就 可 以 了 。 下 面 的 例子 
实现 了 sort.Interface 接 口 的 同时 ， 还 定制 了 输出 函数 。 


type Sequence []int 


// Methods required by sort.Interface. 
func (s Sequence) Len() int { 
return len(s) 


func (s Sequence) Less(i, j int) bool { 
return s[i] < s[j] 

} 

func (s Sequence) Swap(i, j int) { 
s[i], s[j] = s[j], s[i] 


// Method for printing - sorts the elements before printing. 
func (s Sequence) String() string { 
sort.Sort(s) 
str IS ies 
for i, elem := range s { 
aie aL S O 
str += W " 
} 
str += fmt.Sprint(elem) 
} 


return str + "]" 


5.11.2. 转换 


Sequence 的 String 方法 重 做 了 Sprint 在 切片 的 工作 。 我 们 可 以 在 调用 Sprint 前 把 
Sequence 转 为 普通 的 [int。 


func (s Sequence) String() string { 
sort.Sort(s) 
return fmt.Sprint([]Jint(s)) 


转换 使 得 s 被 当 作 普通 的 切片 ， 因 此 得 到 默认 的 排版 。 不 加 转换 ，Sprint 会 发 现 
Sequence 的 String 方法 ， 进 而 无 穷 递归 。 如 果 忽 略 类 型 名 称 ，Sequence 和 [int 
的 类 型 相同 ， 它们 之 间 的 转换 是 合法 的 。 转 换 不 会 得 到 新 值 ， 它 只 是 暂时 假装 现 有 
值 是 新 类 型 。 (其 它 合法 的 转换 ， 如 从 整 型 到 浮 点 型 ， 会 生成 新 值 。) 


地 道 的 Go 程序 会 转换 表达 式 的 类 型 来 使 用 一 组 不 同 的 方法 。 例 如 ， 我 们 可 以 用 现 
有 类 型 sort.IntArray 把 整个 例子 缩减 为 : 


type Sequence []int 


// Method for printing - sorts the elements before printing 
func (s Sequence) String() string { 

sort.IntArray(s).Sort() 

return fmt.Sprint([]int(s)) 


现在 ， 无 需 让 Sequence 实现 多 个 界面 (排序 和 打印 ) ， 我 们 使 用 了 把 数据 转换 为 
多 种 类 型 (Sequence，sort.IntArray 和 [Jint) 的 能 力 ， 每 个 来 完成 一 部 分 的 工作 。 
这 实际 上 不 常见 但 很 有 效 。 


5.11.3. Generality( 泛 化 ) 


如 果 某 类 型 的 存在 只 为 了 实现 某 界面 ， 而 除 此 之 外 没有 其 它 导出 的 方法 ， 则 此 类 型 
也 不 需 导 出 。 只 导出 界面 明确 了 只 有 行为 有 价值 ， 而 不 是 实现 ， 其 它 的 不 同 特性 的 
实现 可 以 镜像 其 原来 的 类 型 。 这 样 也 避免 了 为 同一 方法 的 不 同 实现 做 文档 。 


此 时 ， 架 构 函 数 应 返回 界面 而 不 是 实现 类 型 。 例 如 ， 哈 希 库 的 crc32.NewIEEE() 和 
adler32.New() 都 返回 界面 类 型 hash.Hash32。 替换 一 个 Go 出 现 的 CRC-32 算法 
为 Adler-32 只 需 改变 架构 画 数 的 调用 ; 其 余 的 代码 不 受 算法 改变 的 影响 。 


同样 的 方式 使 得 crypto/block 包 的 流 密 (streaming cipher) 算法 与 链接 在 一 起 的 块 
密 (block cipher) 相 区 隔 。 上 比 对 bu?o 包 ， 它 们 包装 了 界面 ， 返 回 hash.Hash, 
io.Reader 和 io.Writer 界面 值 ， 而 不 是 特定 的 实现 。 


crypto/block 界面 包括 : 


type Cipher interface { 
BlockSize() int 
Encrypt(src, dst []byte) 
Decrypt(src, dst []byte) 


// NewECBDecrypter returns a reader that reads data 
// from r and decrypts it using c in electronic codebook (ECB) m 
func NewECBDecrypter(c Cipher, r io.Reader) io.Reader 


// NewCBCDecrypter returns a reader that reads data 

// from r and decrypts it using c in cipher block chaining (CBC) 
// with the initialization vector iv. 

func NewCBCDecrypter(c Cipher, iv []byte, r io.Reader) i0.Reader 


Pt 
NewECBDecrypter 和 NewCBCReader 不 只 用 于 某 特 定 的 加 密 算 法 和 数据 源 ， 而 
是 任意 的 Cipher 界面 的 实现 和 任意 的 io.Reader。 因 为 它们 返回 io.Reader 界面 


值 ， 蔡 换 ECB 加 密 为 CBC 加 密 只 是 局 部 修改 。 架构 范 数 必须 编辑 ， 但 因为 周围 
代码 必须 只 把 结果 作为 io.Reader， 它 不 会 注意 到 有 什么 不 同 。 


5.11.4. 接口 和 方法 


因为 几乎 任何 东西 都 可 加 以 方法 ， 几 乎 任何 东西 都 可 满足 某 界面 。 一 个 展示 的 例子 
是 http 包 定 义 的 Handler 界面 。 任 何 物件 实现 了 Handler 都 可 服务 HTTP 请 求 。 





type Handler interface { 
ServeHTTP(*Conn, *Request) 
} 


ResponseWrite 本 身 是 个 界面 ， 它 提供 一 些 可 访问 的 方法 来 返回 客户 的 请 求 。 这 
些 方 法 包括 标准 的 Write 方法 。 因 此 http.ResponseWriter 可 用 在 io.Writer 可 以 使 
用 的 地 方 。Request 是 个 结构 ， 包 含 客户 请 求 的 一 个 解析 过 的 表示 。 


为 求 名 jal 条 短 ， 我 们 忽略 POST 并 假 定 所 有 HTTP 7 青 求 都 是 GET ; Ik 间 化 不 会 影响 
手 者 的 设置 。 下 面 一 个 小 而 全 的 经 手 者 实现 了 多 网 页 访问 次 数 的 计数 。 


// Simple counter server. 
type Counter struct { 


n int 

} 

func (ctr *Counter) ServeHTTP(c *http.Conn, req *http.Request) { 
ctr.n++ 
fmt.Fprintf(c, "counter = %d\n", ctr.n) 

} 
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(注意 Fprintf 怎样 打印 到 http.ResponseWriter) 。 作 为 参考 ， 这 里 是 怎样 把 服务 
者 加 在 一 个 URL 树 的 节点 上 。 


import "http" 


ctr := new(Counter) 
http.Handle("/counter", ctr) 


可 是 为 何 把 Counter 作为 结构 呢 ?一 个 整数 能 够 了 。 (接受 者 需 是 指针 ， 使 增 量 带 
回调 用 者 ) 。 


// Simpler counter server. 
type Counter int 


func (ctr *Counter) ServeHTTP(c *http.Conn, req *http.Request) { 
Seth 


fmt.Fprintf(c, "counter = %d\n", *ctr) 
} 


doo o o o 


当 某 页 被 访问 时 怎样 通知 你 的 程序 更 新 某 些 内 部 状态 呢 ? 给 网 页 贴 个 信道 。 


// A channel that sends a notification on each visit. 
// (Probably want the channel to be buffered.) 
type Chan chan *http.Request 


func (ch Chan) ServeHTTP(c *http.Conn, req *http.Request) { 
ch <- req 
fmt.Fprint(c, "notification sent") 


最 后 ， 让 我 们 在 /args 显示 启动 服务 器 时 的 参量 。 写 个 打印 参量 的 函数 很 容易 : 


func ArgServer() { 
for i, s := range os.Args { 
fmt .Println(s) 
} 


怎样 把 它 变 成 HTTP 服务 器 呢 ?我们 可 以 把 ArgServer 作为 某 个 类 型 的 方法 再 忽略 
其 值 ， 也 有 更 干净 的 做 法 。 既 然 我 们 可 以 给 任意 非 指针 和 界面 的 关 型 定义 方法 我 
们 可 以 给 函数 写 个 方法 。http 包 里 有 如 下 代码 : 


// The HandlerFunc type is an adapter to allow the use of 
// ordinary functions as HTTP handlers. If f is a function 
// with the appropriate signature, HandlerFunc(f) is a 

// Handler object that calls f. 

type HandlerFunc func(*Conn, *Request) 


// ServeHTTP calls f(c, req). 

func (f HandlerFunc) ServeHTTP(c *Conn, req *Request) { 
f(c, req) 

} 


HandlerFunc 是 个 带 ServeHTTP 方法 的 类 型 ， 所 以 此 类 的 值 都 可 以 服务 HTTP 请 
求 。 我 们 来 看 看 此 方法 的 实现 : 接受 者 是 个 函数 ，f， 方 法 调用 f。 看 起 来 很 怪 ， 但 
和 ， 上 比如 ， 接 受 者 是 信道 ， 而 方法 发 送 到 此 信道 ， 没 什么 不 同 。 


要 把 ArgServer 变 为 HTTP 服务 器 ， 我 们 首先 改 成 正确 的 签名 : 


// Argument server. 
func ArgServer(c *http.Conn, req *http.Request) { 
for i, s := range os.Args { 
fmt.Fprintln(c, s) 
} 


ArgServer 现在 和 HandlerFunc 有 同样 的 签名 ， 就 可 以 转 成 此 类 使 用 其 方法 ， 就 像 
我 们 把 Sequence 转 为 IntArray 来 使 用 IntArray.Sort 一 样 。 设 置 代码 很 简短 : 


http.Handle("/args", http.HandlerFunc(ArgServer ) ) 


当 有 人 访问 /args 页 时 ， 此 页 的 经 手 者 有 值 ArgServer #1 # #HandlerFunc. HTTP 
服务 器 启动 此 类 型 的 ServeHTTP 方法 ， 用 ArgServer 作为 接受 者 ， 反 过 来 调用 
ArgServer (通过 启动 handlerFunc.ServeHTTP 的 f(w, req) 。) 参量 被 显示 出 来 。 


此 节 中 我 们 从 一 个 结构 ， 整 数 ， 信 道 和 一 个 汞 数 制造 出 一 个 HTTP 服务 器 ， 全 赖 于 
界面 就 是 一 套 方法 ， 可 定义 在 (几乎 ) 任何 类 型 上 。 


5.12. Ais 


Go 不 提供 通行 的 、 类 型 驱动 的 子 类 划分 的 概念 ， 通过 在 结构 或 界面 内 置 ， 确 
实 有 能 力 从 某 实 现 “ 借 " 些 片段 。 


界面 内 置 非常 简单 。 我 们 提 到 过 io.Reader 和 io.Writer 的 界面 ; 这 里 是 其 定义 : 


type Reader interface { 
Read(p []byte) (n int, err os.Error) 


type Writer interface { 
Write(p []byte) (n int, err os.Error) 


io 包 也 导出 一 些 其 它 的 界面 来 规范 实现 其 多 个 方法 的 物件 。 例 如 ，io.ReadWriter 
界面 同时 包括 Read 和 Write 。 我 们 可 以 明确 的 列 出 这 两 个 方法 来 规定 
io.ReadWriter ， 但 更 简单 更 有 启发 的 是 内 置 这 两 个 界面 形成 新 界面 ， 如 下 : 


// Readwrite is the interface that groups the basic Read and writ 
type ReadWriter interface { 

Reader 

Writer 


} 
二 


顾 名 思 意 ，ReadWriter 可 做 Reader 和 Writer 两 个 的 事 ; 它 是 内 置 界 面 的 集合 (A 
须 是 没有 交集 的 方法 ) 。 只 有 界面 可 以 内 置 在 界面 里 。 


同样 的 基本 概念 适用 于 结构 ， 但 牵连 更 广 。bu?o 包 有 两 个 结构 类 型 ，bu?o.Reader 
和 bu?o.Writer ， 每 个 都 当然 对 应 实现 着 io 包 的 界面 。 并 且 ，bu?o 也 实现 了 缓冲 
的 读 写 ， 这 是 通过 把 reader 和 writer 内 置 到 一 个 结构 做 到 的 ; 它 列 出 类 型 但 不 给 
名 称 : 





// Readwriter stores pointers to a Reader and a Writer. 
// It implements io.ReadWwriter. 
type ReadWriter struct { 

*Reader // *bufio.Reader 

*Writer // *bufio.Writer 


内 置 元 素 是 指针 所 以 使 用 前 必须 初始 化 指向 有 效 的 结构 。 ReadWriter 结构 可 以 写 
为 : 


type ReadWriter struct { 
reader *Reader 
writer *Writer 


但 要 提升 域 的 方法 又 要 满足 io 界面 ， 我 们 还 需 提 供 转 发 方法 ， 如 : 


func (rw *ReadWriter) Read(p []byte) (n int, err os.Error) { 
return rw.reader.Read(p) 
} 


通过 直接 内 置 结 构 ， 我 们 避免 了 这 些 账目 管理 。 内 置 类 型 的 方法 是 附送 的 ， 亦 即 
bu?0.ReadWriter 除了 有 bu?0.Reader 和 bu?o.Writer 的 方法 ， 还 同时 满足 三 个 界 
面 : io.Reader, io.Writer 和 io.ReadWriter 。 


内 置 和 子 类 划分 有 着 重要 不 同 。 我 们 内 置 类 型 时 ， 此 类 的 方法 成 为 外 层 类 型 的 方 
法 ， 但 调用 时 其 接受 者 是 内 层 类 型 ， 而 不 是 外 层 。 我 们 的 例子 里 ， 当 bu? 
o.ReadWriter 的 Read 方法 被 调用 时 ， 它 的 效果 和 上 面 所 写 的 转发 方法 完全 一 样 ; 
接受 者 是 ReadWriter 的 reader， 而 不 是 ReadWriter 自身 。 


内 置 也 用 来 提供 某 种 便利 。 下 例 是 一 个 内 置 域 和 普通 的 ， 带 名 的 域 在 一 起 : 


type Job struct { 
Command string 
*log. Logger 


此 时 Job 类 型 有 Log, Logf HE *log.Logger 的 方法 。 我 们 当然 可 以 给 Logger 
个 名 字 ， 但 无 此 必要 。 这 里 ， 初 始 化 后 ， 我 们 可 以 log Job: 


job.Log("starting now...") 


Logger 是 结构 的 普通 域 所 以 我 们 能 用 通常 的 架构 函数 初始 化 它 : 


func NewJob(command string, logger *log.Logger) *Job { 
return 

&Job{command, logger} 

} 


或 使 用 组 合 字面 : 


job := &Job{command, log.New(os.Stderr, nil, "Job: ", log.Ldate) 
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如 果 我 们 需要 直接 引用 内 置 域 ， 域 的 类 型 名 ， 忽 略 包 标识 ， 可 作为 域名 。 如 果 我 们 
要 得 到 Job 变量 job 的 *log.Logger， 我 们 用 job.Logger 。 这 可 用 在 细 化 Logger 的 
方法 上 : 


func (job *Job) Logf(format string, args ...) { 
job.Logger.Logf("%q: %s", job.Command, fmt.Sprintf(format, at 


} 








AEXES KEZA, (ARRAS. BH, RRDA X 隐藏 此 类 型 更 深 
层 部 分 的 X 项 。 如 果 log.Logger 包括 叫 Command 的 域 或 方法 ， 则 Job 的 
Command 域 占 主 导 权 。 

其 次 ， 如 果 同 层 出 现 同名 ， 通 常 是 个 错误 ; 如 果 Job 结构 有 另 一 域 或 方法 叫 
Logger, 2AE log.Logger 会 出 错 。 但 只 要 重 名 在 类 型 定义 外 的 程序 中 不 被 提 及 ， 
就 不 成 问题 。 此 条 件 提供 了 改动 外 部 的 内 置 类 型 的 某 种 保护 ; 只 要 两 个 域 都 没 被 用 
到 ， 新 增 的 域名 和 另 一 子 类 的 域 重 名 也 没有 问题 。 


5.13. 并 发 


5.13.1. 交流 来 分 享 

并 发 编程 是 很 大 的 主题 ， 此 你 只 够 讲 Go 方面 的 要 点 。 

很 多 环境 的 并 发 编程 变 得 困难 出 自 于 实现 正确 读 罕 共 享 变量 的 微妙 性 。Go 鼓励 一 
种 不 一 样 的 方式 ， 这 里 ， 共 享 变量 在 信道 是 传递 ， 并 且 事 实 上 ， 从 来 未 被 独立 的 执 
行 序 列 所 共享 。 每 一 特定 时 间 只 有 一 个 够 程 在 存 取 该 值 。 从 设计 上 数据 竞争 就 不 会 
发 生 。 为 鼓励 这 种 思考 方式 我 们 把 它 缩减 成 一 句 口 号 : 

> 别 靠 共 享 内 存 来 通信 ， 要 靠 通信 来 分 享 内 存 ! 


此 方式 可 扯 的 太 远 。 例 如 ， 引 用 计数 最 好 靠 整 型 变量 外 加 一 个 互 斥 。 但 最 为 高 层 方 
式 ， 使 用 信道 控制 存 取 可 以 更 容易 写成 清楚 正确 的 程序 。 

思考 这 种 模型 一 种 方式 是 考虑 在 单一 CPU 上 运行 的 典型 的 单线 程 程序 ， 不 需 用 到 
同步 原 语 。 现 在 多 运行 一 份 ; 也 同样 不 需 同步 。 现 在 让 两 者 通信 ; 如 果 通 信和 是 同步 
者 ， 还 是 不 需 其 它 的 同步 。 例 如 ，Unix 的 管道 完美 的 适合 这 个 模型 。 尽 管 Go 的 并 
行 方式 源 自 Hoare 的 通信 顺序 进程 (CSP) ， 它 也 可 视 为 泛 化 的 类 型 安全 的 Unix 


管道 。 


5.13.2. Goroutines(Go 程 ) 


它们 叫做 够 程 ， 是 因为 现 有 的 术语 -- 线程 ， 协 程 和 进程 等 -- 传达 的 含义 不 够 精 
确 。 够 程 的 模式 很 简单 : 它 是 在 同一 地 址 空间 和 其 它 够 程 并 列 执行 的 函数 。 它 轻 
和 鳃 ， 只 比分 配 堆 栈 空间 多 费 一 点 儿 。 因 为 堆栈 开始 时 很 小 ， 所 以 它们 很 便宜 ， 只 在 
需要 时 分 配 (和 释放 ) HERE. 


够 程 在 多 个 OS 线程 间 复 用 ， 所 以 如 果 茶 个 需要 阻塞 ， 例 如 在 等 待 上 DO， 其 它 的 可 继 
续 执行 。 它 们 的 设计 隐藏 了 许多 线程 生成 和 管理 的 复杂 性 。 


在 某 个 范 数 或 方法 前 加 上 go 键 字 则 在 新 够 程 中 执行 此 调用 。 当 调用 完成 ， 够 程 安 
静 的 退出 。 (效果 类 似 Unix shell 的 & -- 在 后 台 执 行 命 令 。 ) 


go list.Sort() // run list.Sort in parallel; don't wait for it. 
Se ee nm: 
函数 字面 在 实施 够 程 上 很 顺手 : 


func Announce(message string, delay int64) { 
go func() { 
time.Sleep(delay) 
fmt.Println(message) 
}() // Note the parentheses - must call the function. 


在 Go Ẹ, WAFHeWA: 实现 保证 函数 引用 的 变量 可 以 活 到 它们 不 在 用 了 。 
这 些 例子 没什么 用 处 ， 因 为 妙 数 无 法 通知 其 结束 。 那 需 用 到 信道 。 
5.13.3. Channels( 信 道 ) 


类 型 映射 ， 信 道 是 引用 类 型 ， 使 用 make 分 配 。 如 果 提 供 了 可 选 的 整 型 参量 ， 它 会 
设置 信道 的 缓冲 大 小 。 默 认 是 0， 即 无 缓冲 的 或 同步 的 信道 。 


Ci := make(chan int) // unbuffered channel of integer: 
cj := make(chan int, 0) // unbuffered channel of integer: 
cs := make(chan *os.File, 100) // buffered channel of pointers 1 





信道 结合 了 通信 -- 即 值 的 交换 -- 和 同步 -- 确保 两 个 计算 ( 够 程 》 处 于 某 个 已 知 状 


信道 有 很 多 惯用 语 。 先 从 一 个 开始 。 上 节 我 们 启动 了 个 后 台 的 排序 。 信 道 使 启动 够 
程 能 等 待 排序 完成 。 
c := make(chan int) // Allocate a channel. 
// Start the sort in a goroutine; when it completes, signal on tt 
go func() { 


list.Sort() 
c <- 1 // Send a signal; value does not matter. 


}() 
doSomethingForAwhile() 


<-C // Wait for sort to finish; discard sent value. 
加 = = 


接收 者 阻塞 到 有 数据 可 以 接收 。 如 果 信 道 是 非 缓 冲 的 ， 发 送 者 阻塞 到 接收 者 收 到 其 
值 。 如 果 信 道 有 缓冲 ， 发 送 者 只 需 阻 塞 到 值 拷贝 到 缓冲 里 ; 如 果 缓 冲 满 ， 则 等 待 直 
到 某 个 接收 者 取 走 一 值 。 


一 个 缓冲 信道 可 以 用 作 信 号 灯 ， 上 比如 用 来 限 速 。 下 例 中 ， 到 来 请 求 传递 给 handle， 
来 发 送 一 值 到 人 入道， 处理 请 求 ， 以 及 才 信 道 接 收 值 。 信 道 的 容量 决定 了 可 同时 调用 
process 的 数量 。 





var sem = make(chan int, MaxOutstanding) 


func handle(r *Request) { 


sem <- 1 // Wait for active queue to drain. 
process(r) // May take a long time. 
<-sem // Done; enable next request to run. 
} 
func Serve(queue chan *Request) { 
for { 
req := <-queue 
go handle(req) // Don't wait for handle to finish. 
} 
} 


同样 的 概念 ， 我 们 可 以 启 启动 一 定数 量 的 handle 够 程 ， 全 都 读 取 请 青 求 信道 。 够 程 的 
数量 限制 同时 调用 process 的 数量 。 此 Serve 函数 也 接受 一 个 信道 来 千 知 它 退 出 ; 
够 程 启动 后 会 接收 阻塞 在 此 信道 。 


func handle(queue chan *Request) { 
for r := range queue { 
process(r) 


} 


func Serve(clientRequests chan *clientRequests, quit chan bool) -+ 
// Start handlers 
for i := OF i < MaxOutstanding; i++ { 
go handle(clientRequests) 


<-quit // Wait to be told to exit. 





5.13.4. Channels of channels( 信 道 的 信道 ) 


Go 的 一 个 最 重要 的 特色 是 信道 作为 一 等 值 可 以 被 分 配 被 传递 ， 正 如 其 它 的 值 。 此 
特色 常用 来 实现 安全 并 行 的 分 路 器 。 


上 节 的 例子 里 ， ea 径 手 者 ， 但 我 们 并 未 定义 其 经 手 的 类 型 。 
如 果 此 类 型 包括 一 个 可 回 发 的 信道 ， 每 个 客户 都 可 提供 自身 的 回答 途径 。 下 面 是 类 
型 Request 的 语义 定义 。 


type Request struct { 
args []int 
f func([]int) int 
resultChan chan int 


客户 提供 一 个 函数 及 其 参量 ， 以 及 在 请 求 物件 里 的 一 个 信道 ， 用 来 接收 答案 。 


func sum(a []int) (s int) { 
for _, v := range a { 
s t= Vv 
} 


return 


} 


request := &Request{[]int{3, 4, 5}, sum, make(chan int)} 
// Send request 

clientRequests <- request 

// Wait for response. 

fmt.Printf("answer: %d\n", <-request.resultChan) 


服务 器 端 ， 经 手 函 数 是 唯一 需要 改变 的 。 


func handle(queue chan *Request) { 
for req := range queue { 
req.resultChan <- req.f(req.args) 


} 


当然 还 要 很 多 工作 使 其 实际 ， 但 此 代码 是 个 速率 限制 、 并 行 、 非 阻塞 的 RPC 系统 
的 框 娘 ， 而 且 看 不 到 一 个 互 斥 。 


5.13.5. 并 发 


这 些 概念 的 另 一 应 用 是 在 多 CPU 核 上 并 发 计算 。 如 果 一 个 运算 可 以 分 解 为 独立 片 
段 ， 则 可 并 发 ， 用 一 信道 通知 每 个 片段 的 结 


人 每 个 项 的 运算 值 都 是 独立 的 ， 如 下 
ill : 


type Vector []float64 


// Apply the operation to v[i], v[i+1] ... up to v[n-1]. 
func (v Vector) DoSome(i, n int, u Vector, c chan int) { 
for a ds mM; ae i 
v[i] += u.Op(v[i]) 


c<- 1 // signal that this piece is done 


我 们 在 循环 里 单独 启动 片段 ， 每 个 CPU 一 个 。 它们 谁 先 完成 都 没关系 ; 我 们 只 是 
启动 全 部 够 程 前 清空 信道 ， 再 数 数 结束 通知 即 可 。 


const NCPU = 4 // number of CPU cores 


func (v Vector) DoAll(u Vector) { 
c := make(chan int, NCPU) // Buffering optional but sensible 
for i := 0; i < NCPU; i++ { 
go v.DoSome(i*len(v)/NCPU, (i+1)*len(v)/NCPU, u, ©) 
// Drain the channel. 
for i := 0; i < NCPU; i++ { 
<-C // wait for one task to complete 


} 
// All done. 





现在 的 gc 实现 〈6g 等 ) 不 会 默认 的 并 发 此 代码 。 它 只 投入 一 个 核 给 用 户 层 的 运 
算 。 任 意 多 的 够 程 可 以 阻塞 在 系统 调用 上 ， 但 默认 的 每 个 时 刻 只 有 一 个 可 以 执行 用 
户 层 的 代码 。 它 本 该 更 聪明 些 ， 某 天 它 会 变 陪 明 ， 但 那 之 前 如 果 你 要 并 发 CPU 就 
必须 告知 运行 态 你 要 同时 执行 代码 的 够 程 的 数量 。 有 两 种 相关 的 办 法 ， 或 者 你 把 环 
境 变量 GOMAXPROCS 设 为 你 要 用 到 的 核 数 (默认 1) ; RASA runtime 包 调 用 
runtime.GOMAXPROCS(NCPU)。 再 提 一 青 ， 此 要 求 会 随 着 调度 及 运行 态 的 进步 而 
退休 。 


5.13.6. 漏水 缓冲 


并 发 编程 的 工具 也 可 用 来 使 非 并 发 的 概念 更 容易 表达 。 下 例 是 从 某 个 RPC 包 里 提取 
的 。 客 户 够 程 循 环 接收 数据 自 某 源 ， 可 能 是 网 络 。 为 免 分 配 释放 缓冲 ， 它 保有 一 个 
自由 列 ， 并 由 一 个 缓冲 的 信道 代表 。 如 果 信 道 空 ， 则 新 缓冲 被 分 配 。 当 消息 缓冲 好 
时 ， 它 在 serverChan 上 发 给 服务 器 。 


var freeList = make(chan *Buffer, 100) 
var serverChan = make(chan *Buffer ) 


func client() { 
for { 
b, ok := <-freeList // grab a buffer if available 
if !ok { // if not, allocate a new one 
b = new(Buffer) 


load(b) // read next message from the net 
serverChan <- b // send to server 


服务 器 循环 读 消息 自 客户 ， 人 处 理 ， 返 回 缓冲 到 自由 列 。 


func server() { 


for { 
b := <-serverChan // wait for work 
process(b) 
_ = freeList <- b // reuse buffer if room 
} 


客户 无 阻 的 从 freeList 得 到 一 个 缓冲 ， 如 还 没有 则 客户 分 配 个 新 的 缓冲 。 服 务 器 无 
阻 的 发 送 给 freeList， 放 b 回 自由 列 ， 除 非 列 满 ， 此 时 缓冲 掉 到 地 板 上 被 垃圾 收集 
器 回收 。 (发送 操作 赋值 给 空白 标识 使 其 无 阻 但 会 忽略 操作 是 否 成 功 。) 此 实现 仅 
用 几 行 就 打造 了 个 漏水 缓冲 ， 靠 缓冲 信道 和 垃圾 收集 器 记 账 。 


5.14. 错误 处 理 


一 些 画 数 在 调用 后 返回 一 些 错误 的 标志 。 在 Go 中 我 们 可 以 用 返回 返回 多 个 值 
来 方便 地 处 理 错 误 本 E 一 般 情 况 下 ， 错 误 都 实现 了 os.Error 接口 。 


type Error interface { 
String() string 


库 的 编写 者 一 般 会 在 os.Error 接 口 的 基础 上 扩展 更 多 的 信息 ， SAAE 可 以 
知道 错误 的 更 多 细节 。 例 如 : os.Open 返 回 的 是 os.PathError 类 型 错误 (里面 已 经 
包含 最 基本 的 错误 接口 ) 。 


// PathError records an error and the operation and 
// file path that caused it. 
type PathError struct { 

Op string // "open", "unlink", etc. 

Path string // The associated file. 

Error Error // Returned by the system call. 


} 
func (e *PathError) String() string { 

return e.Op + " " + e.Path + ": " + e.Error.String() 
} 


PathError 生 成 的 String 错 误 信 息 如 下 : 


open /etc/passwx: no such file or directory 


错 错误 信 息 包 含 了 要 操作 的 文件 名 ， 对 文件 的 具体 操作 ， 以 及 操作 系统 返回 的 错 
eile 息 。 这 样 肯定 比 简单 输出 "no such file or directory" 错 误 信 息 更 有 价值 。 


人 村 数 调用 者 想 获 取 错 误 的 全 部 细节 ， 那 么 需要 将 错误 结果 从 基本 的 类 型 动态 转 
RE 更 具体 的 错误 类 型 。 例 如 : 下 面 的 代码 特 Error 转 换 为 PathErrors 类 类 型 ， 因 为 
aes 吴 细 细 更 加 丰富 。 


for try := 0; try < 2; try++ { 
file, err = os.Open(filename, os.O_RDONLY, 0) 
if err == nil { 
return 


} 


if e, ok := err.(*os.PathError); ok && e.Error == os.ENOSPC - 
deleteTempFiles() // Recover some space. 
continue 


} 


return 





q 





5.14.1. Panic( 怕 死 ) 


通常 报错 的 方式 是 给 调用 者 一 个 多 于 的 os.Error 的 返回 值 。 经 典 的 Read 方法 是 个 

出 名 的 实例 ; 它 返 回 字 节 数 和 os.Error 。 但 错误 不 可 恢复 则 如 何 ? 有 时 程序 就 是 不 
AY FB aK To 

AFILBN, ABBE panic 实际 上 会 生成 一 个 运行 态 错误 来 终止 程序 (但 参见 下 
节 ) 。 此 函数 取 一 个 任意 类 型 的 参量 一 一 通常 是 字 串 一 一 在 程序 死 掉 时 打印 。 它 

也 用 来 指出 某 种 不 可 能 的 事情 发 生 了 ， 例 http://code.google.com/p/ac-me/ 99 如 从 

永久 循环 中 退出 了 。 实 际 上 ， 编 辑 器 看 到 函数 尾 的 panic 会 压制 通常 的 return 语句 
检查 。 





// A toy implementation of cube root using Newton's method. 
func CubeRoot(x float64) float64 { 
Z := x/3 // Arbitrary intitial value 
for i := 0; i < 1e6; i++ { 
prevz := Zz 
Z (2 2200/ (3 2 2) 
if veryClose(z, prevz) { 
return z 


} 


// A million iterations has not converged; something is wronc¢ 
panic(fmt.Sprintf("CubeRoot(%g) did not converge", x)) 





RREMMIF, TÉRRA ERE panic. WRZ HARRA, o 
UE iL Sake AR eH EE ER. ARERR EE, aR EM 
怎么 都 不 能 安排 好 自己 ， 有 理由 panic， 可 以 这 么 说 。 


var user = os.Getenv("USER") 


func init() { 
if user == "" 
panic("no value for $USER") 


5.14.2. Recover( 回 生 ) 


当 panic 被 叫 ， 包 括 运 行 态 错误 例如 数组 下 标 越界 或 类 型 断言 失败 时 ， 它 会 立即 停 
止 当 前 函数 的 执行 ， 并 开始 退 绕 够 程 的 堆栈 ， 随 之 运行 所 有 的 延迟 画 数 。 如 果 退 绕 
到 够 程 堆栈 顶 ， 程 序 死 掉 。 但 是 ， 我 们 可 以 用 内 部 责 数 recover 重新 控制 够 程 ， 恢 
复 正 常 运 行 。 


recover 的 调用 终止 退 绕 并 返回 传 给 panic 的 参量 。 因 为 退 绕 时 只 有 延迟 玉 数 的 代 
码 在 运行 ，recover 只 在 延迟 函数 有 用 。 


recover 的 一 个 用 途 是 在 服务 器 内 关闭 失败 的 够 程 而 不 会 杀 死 其 它 正 在 运行 的 够 


程 。 


func server(workChan <-chan *Work) { 
for work := range workChan { 
go safelyDo(work) 
} 


} 


func safelyDo(work *Work) { 
defer func() { 
if err := recover(); err != nil { 
log.Stderr("work failed:", err) 


}() 
do (work) 


此 例子 中 ， 如 果 do(work) panic 了 ， 结 果 会 记录 下 ， 够 程 会 不 扰 人 的 干净 地 退出 。 
WEE TER HAUKAAS ; recover 的 调用 完全 可 以 义理 。 


意 有 了 这 种 复原 的 模式 ，do NR (及 其 所 有 的 调用 ) 可 以 用 panic 从 任何 糟糕 的 情 
况 里 脱身 。 我 们 可 用 此 概念 简化 复杂 软件 的 出 错 处 理 。 我 们 看 看 regexp 包 里 一 个 
理想 化 的 节选 ， 它 用 局 部 的 Error 类 型 调用 panic 来 报错 。 下 面 是 Error，error 方 
法 ， 和 Compile HAMS : 


// Error is the type of a parse error; it satisfies os.Error. 
type Error string 
func (e Error) String() string { 

return string(e) 


} 


// error is a method of *Regexp that reports parsing errors by 
// panicking with an Error. 
func (regexp *Regexp) error(err string) { 

panic(Error(err)) 


// Compile returns a parsed representation of the regular expres: 
func Compile(str string) (regexp *Regexp, err os.Error) { 
regexp = new(Regexp) 
// doParse will panic if there is a parse error. 
defer func() { 
if e := recover(); e != nil { 
regexp = nil // Clear return value. 
err = e.(Error) // Will re-panic if not a parse erro! 


} 
i) 


return regexp.doParse(str), nil 








如 果 doParse panic 了 ， 复 原 块 会 设置 返回 值 为 nil 延迟 图 数 可 以 修改 带 名 的 返 
回 值 。 它 然后 通过 断定 err 的 赋值 是 类 型 Errr 来 检查 问题 出 自 语法 分 析 。 如 果 不 
是 ， 类 型 断言 会 失败 ， 导 致 一 个 运行 态 错 误 ， 继 续 堆 栈 退 绕 ， 就 好 像 无 事 发 生 一 
样 。 这 个 检查 意味 着 如 果 未 便 预 料 的 事情 发 生 了 ， 例 如 数组 下 标 越 界 ， 代 码 会 失 
w, RERNA T panic 和 recover 出 来 用 户 触发 的 错误 。 


有 了 这 种 出 错 处 理 ，error 方法 能 轻易 的 报错 ， 而 不 需 担 心 自己 动手 退 绕 堆 栈 。 


这 种 有 用 的 模式 只 应 在 一 个 包 的 内 部 使 用 。 Parse 将 其 内 部 的 panic 调用 转 为 
os.Error 值 ; 不 把 panic 暴露 给 客户 。 这 个 好 规则 值得 效法 。 


5.15. Web 服 务 器 


现在 让 我 们 来 实现 一 个 完整 的 程序 : 一 个 简单 的 web 服 务 器 。 这 其 实 是 一 个 转发 服 
务 器 。 google 的 http://chart.apis.google.com 提供 了 一 个 将 数据 转换 为 图 表 的 服 

务 。 不 过 那个 图 表 的 转换 程序 使 用 比较 复杂 ， 因 为 需要 用 户 自己 设置 各 种 参数 。 不 
过 我 们 这 里 的 程序 界面 要 稍微 友好 一 点 : 因为 我 们 只 需要 获取 一 小 段 数据 ， 然后 调 
用 google 的 图 表 转 换 程序 生存 QR 码 (Quick Response 缩 写 ， 二 维 条 码 ) ， 对 于 文 
本 信息 下 编码 。 二 维 条 码 图 像 可 以 用 手机 上 的 摄像 机 采集 ， 然 后 解析 得 到 解码 后 的 


信息 。 


下 面 是 完整 的 程序 : 


package main 


import ( 
"flag" 
"http" 
UON 
"log" 
"strings" 
"template" 

) 


var addr = flag.String("addr", ":1718", "http service address") , 
var fmap = template.FormatterMap{ 

"html": template.HTMLFormatter, 

"urlt+thtml": UrlHtmlFormatter, 


var templ = template.MustParse(templateStr, fmap) 


func main() { 
flag.Parse() 
http.Handle("/", http.HandlerFunc(QR) ) 
err := http.ListenAndServe(*addr, nil) 
if err != nil { 
log.Exit("ListenAndServe:", err) 


} 

func QR(c *http.Conn, req *http.Request) { 
templ.Execute(req.FormValue("s"), c) 

} 


func UrlHtmlFormatter(w io.Writer, v interface{}, fmt string) { 
template.HTMLEscape(w, strings.Bytes(http.URLEscape(v.(strinc¢ 
} 


const templateStr = ` 
<html> 


<head> 
<title>QR Link Generator</title> 
</head> 
<body> 
{.section @} 
<img src="http://chart.apis.google.com/chart?chs=300x300&cht: 
/> 
<br> 
{@| html} 
<br> 
<br> 
{.end} 
<form action="/" name=f method="GET"> 
<input maxLength=1024 size=70 name=s value="" title="Text 
<input type=submit value=&##34; Show QR" name=qr> 
</form> 
</body> 
</html> 


a] = ee 
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还 有 一 个 模板 变量 templ， 主 要 用 于 保存 HTML 页 面 的 生成 模板 ， 我 们 稍 后 会 讨论 。 


main 首 先 分 析 命 合 行 选项 ， 然 后 帮 定 QR 画 数 为 服务 器 的 根 目 录 处 理 函 数 。 最 后 
http.ListenAndServe 馈 动 服务 器 ， 并 在 服务 器 运行 期 间 一 直 阻塞 。 


QR 接收 客户 端 请 求 ， 然 后 用 表单 中 的 s 变 量 的 值 蔡 换 到 模板 。 


template 包 实现 了 json-template。 我 们 的 程序 的 简洁 正 是 得 益 于 template 包 的 强大 
功能 。 本 质 上 ， 在 执行 templ.Execute 的 时 候 ， 根 据 需要 替换 调 模板 中 的 某 些 区 
域 。 这 里 的 原始 模板 文本 保存 在 templateStr 中 ， 其 中 花 括 弧 部 分 对 应 模板 的 动作 。 
在 {.section @} 和 {.end} 之 间 的 以 @ 开 头 的 元 素 ， 在 义理 模板 的 时 候 会 被 蔡 换 。 


标记 {@|url+html} 的 意思 是 在 格式 化 模板 的 时 候 ， 用 格式 化 字典 (fmap) 
中 "url+html" 关键 字 对 应 的 函数 的 义理 标签 的 蔡 代 文本 。 这 里 的 UrlIHtmIFormatter 
画 数 ， 只 是 为 了 安全 和 启 见 过 滤 包 含 的 不 合法 信息 。 


这 里 的 模板 只 是 用 于 显 式 的 html 页 面 。 如 果 觉 得 上 面 的 解释 比较 简略 的 话 ， 可 以 看 
到 template 包 的 documentation。 


我 们 仅仅 用 很 少 的 代码 加 一 些 HTML 文 本 就 实现 了 一 个 有 意思 的 webserver。 使 用 
go， 往 往 用 很 少 的 代码 就 能 实现 强大 的 功能 。 
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6.1. 简介 


本 文档 会 介绍 如 何 编写 一 个 新 的 包 ， 以 及 如 何 测试 代码 。 本 文档 假设 读者 已 经 根据 
安装 指南 成 功 地 安装 了 Go。 


在 着 手 修 改 已 有 的 包 或 是 新 建 包 之 前 ， 一 定 要 先 把 自己 的 想法 发 到 邮件 列表 。 


6.2. 社区 资源 

寻求 实时 帮助 ， 可 以 在 Freenode IRC 服 务 器 的 #go-nuts 频 道里 找到 其 他 的 用 户 或 是 
开发 人 员 o 

Go 语言 的 官方 邮件 列表 是 Go Nuts. 

报告 Bug 可 以 使 用 Go 问题 追踪 器 。 


对 于 想 及 时 了 解 开 发 进度 的 读者 ， 可 以 加 入 另 一 个 邮件 列表 golang-chenkins， 这 样 
在 有 人 往 Go 代 码 库 中 checkin 新 代码 时 就 会 收 到 一 封 简要 的 邮件 。 


6.3. 新 建 一 个 包 


根据 一 般 约 定 ， 导 入 路 径 为 x/y 的 包 的 源 代码 应 放 在 h$GOROOT/src/pkg/x/y 目 录 中 。 


6.3.1. Makefile 


如 果 能 有 专门 针对 Go 的 工具 能 检测 源 代码 文件 ， 决 定编 译 顺序 就 好 了 ， 但 现在 ， 我 
们 还 只 能 用 GNU 的 make。 所 以 ， 新 建 包 首先 要 新 建 的 文件 就 是 Makefile。 如 果 是 在 
Go 源 代码 树 中 ， 其 基本 格式 可 参照 src/pkg/container/vector/Makefile : 


include ../../../Make.inc 
TARG=container/vector 
GOFILES= intvector.go stringvector.go vector.go 


| 
在 Go 的 源 代 码 树 之 外 (个 人 包 ) ， 标 准 的 格式 则 是 : 





include $(GOROOT)/src/Make. inc 
TARG=mypackage 
GOFILES= my1.go my2.go include $(GOROOT)/src/Make.pkg 


a 了 陋 "| 


第 一 行 和 最 后 一 行 分 别 导 人 了 标准 定义 和 规则 。Go 源 代码 树 中 所 维护 的 包 使 用 相对 
路 径 (代替 $(GOROOT)/src) ， 所 以 即使 是 $(GOROOT) 中 含有 空格 也 可 以 正常 使 
用 。 这 无 疑 简 化 了 程序 员 党 试 Go 的 难度 。 


如 果 没 有 设置 $SGOROOT 环 境 变量 ， 在 运行 gomake 时 就 必须 使 用 第 二 种 makefile。 
即使 系统 中 的 GNU Make 的 名 字 是 gmake 而 不 是 make，Gomake 也 能 正常 的 调用 
mo 
Ko 


TARG 是 这 个 包 的 目标 安装 路 径 ， 就 是 客户 用 来 导 人 这 个 包 的 字符 串 。 在 Go 的 源 代 
码 树种 ， 这 个 字符 串 必须 跟 Makefile 中 的 目录 保持 一 致 ， 不 需 要 
$GOROOT/src/pkg/ 前 级 。 在 Go 的 源 代码 树 之 外 ， 则 可 以 使 用 任何 跟 标 准 Go 包 名 
称 不 冲突 的 TARG。 一 个 常见 的 规则 是 用 一 个 独 有 的 名 称 把 自己 的 包 组 合 在 一 起 ， 
例如 : myname/tree、 myname/filter 等 。 注 意 ， 即 使 包 的 源 代码 是 放 在 Go 源 代码 
树 外 部 ， 为 了 便于 编译 器 找到 你 的 包 ， 运 行 make install 之 后 最 好 也 把 编译 后 的 包 放 
到 标准 位 置 ， 即 $GOROOT/pkg。 


GOFILES 是 创建 名 所 需要 编 详 的 源 代码 文件 清单 。 用 反 任 杠 符号 \ 就 能 将 这 份 清音 
分 成 多 行 ， 方 便 排序 。 


如 果 在 Go 的 源 代 码 树 中 新 建 包 目录 ， 只 需要 将 其 添加 到 
$GOROOT/src/pkg/Makefile 的 清单 中 ， 就 能 将 其 包含 在 标准 构建 中 。 然 后 运行 : 


cd $GOROOT/src/pkg 
./deps.bash 


这 是 更 新 依赖 文件 Make.deps。 (每 次 运行 all.bash 或 make.bash 时 都 会 自动 执行 此 
操作 。) 


如 果 是 修改 一 个 已 有 的 包 ， 就 不 需要 编辑 $8GOROOT/src/pkg/Makefile， 不 过 运行 
deps.bash 还 是 必须 的 。 


6.3.2. Go 源 文 件 


对 于 每 个 源 代 码 文件 ， 在 Makefile 中 的 命令 首先 是 包 的 名 称 ， 该 名 称 也 是 导 和 人 包 的 
默认 名 称 。 (同一 个 包 中 所 有 文件 必须 使 用 同一 个 名 称 。) Go 的 规则 是 ， BHA 
称 是 导入 路 径 的 最 后 一 个 元 素 ， 例 如 以 “crypto/rot13” 为 导入 路 径 的 包 的 名 称 应 该 是 
rot13。 现 在 ，Go 工 具 还 要 求 链接 到 同一 个 二 进 制 文件 的 所 有 包 的 名 称 都 应 该 是 唯 
一 的 ， 但 这 个 限制 很 快 就 会 被 移 除 。 


Go 会 一 次 性 编译 包 中 所 有 的 源 代码 文件 ， 所 以 源 代码 中 可 以 试用 其 它 文件 中 的 常 
=, FB. PMWM, MAR RH RA. 


编写 简洁 易 懂 的 Go 代码 超出 了 本 文档 的 范围 。Effective Go 对 此 有 介绍 。 


6.4. 测试 


Go 有 一 个 名 为 gotest 的 轻 量 级 测试 框架 。 编 写 测 试 首先 要 创建 一 个 文件 名 以 
_test.go 结 尾 的 文件 ， 然 后 在 其 中 加 入 名 为 TestXXX 且 签名 是 (t *testing. TAWA. 
测试 框架 会 逐个 地 运行 此 类 辑 数 ; 如 果 画 数 调 用 了 失败 函数 ， 例 如 t.Error 或 t.Fail， 
测试 就 会 失败 。gotest 命 令 的 文档 和 testing 包 的 文档 中 有 关于 测试 的 详细 信息 。 


不 需要 在 Makefile 中 列 出 * test.go 文 件 。 


运行 make test 或 gotest 就 能 运行 测试 〈 两 个 命令 是 等 价 的 ) 。 如 果 只 需要 运行 单个 
测试 文件 中 的 测试 ， 例 如 one test.go， 执 行 gotest one _test.go 即 可 。 


如 果 关 心 程序 的 性 能 ， 可 以 添加 一 个 Benchmark 函 数 ( 详 见 gotest 命 命 文档) ， 然 
后 用 gotest -benchmarks=. i 77% HR. 


代码 通过 测试 后 ， 就 可 以 提交 给 别人 审查 了 。 


6.5. 一 个 带 测 试 的 演示 包 


这 个 演示 用 的 包 numbers 含 有 一 个 函数 Double， 其 参数 为 一 个 整数 ， 返 回 值 刘 是 将 
该 整数 乘 以 2。 这 个 包 由 三 个 文件 组 成 : 


第 一 个 ， 包 的 实现 ，numbers.go: 


package numbers 


func Double(i int) int { 
return i * 2 


} 


接 下 来 是 测试 ，numbers_test.go : 


package numbers 


import ( 
"testing" 
) 


type doubleTest struct { 
in, out int 


} 


var doubleTests = [ ]doubleTest{ 
doubleTest{i, 2}, 
doubleTest{2, 4}, 
doubleTest{-5, -10}, 


} 


func TestDouble(t *testing.T) { 
for _, dt := range doubleTests { 
v := Double(dt.in) 
if v != dt.out { 
t.Errorf("Double(%d) = %d, want %d.", dt.in, v, dt.ol 





最 后 是 Makefile : 


include $(GOROOT)/src/Make.inc 
TARG=numbers 
GOFILES= numbers.go include $(GOROOT)/src/Make.pkg 


运行 gomake 构 建 并 将 这 个 包 安 装 到 $GOROOT/pkg/ (可 供 系 统 上 的 所 有 程序 使 


o 


执行 gotest 测 试 会 重建 这 个 包 ， 包 括 numbers _test.go 文 件 ， 然 后 运行 TextDouble 酚 
数 。 输 出 "PASS" 表 示 所 有 测试 都 成 功 通过 。 把 实现 中 的 乘 数 从 2 改 成 3 就 能 看 到 测试 
失败 的 报告 。 


更 多 细节 请 参考 gotest 文 档 和 testing 包 的 文档 。 


7. Codelab: 编写 Web 程 序 


7.1. 简介 


这 个 例子 涉及 到 的 技术 : 


。 创建 一 个 数据 类 型 ， 含 有 load 和 save 辑 数 
。 基于 http 包 创建 web 程 序 

。 基于 template 包 的 html 模 板 技术 

。 使 用 regexp 包 验证 用 户 输入 

。 HAA 


假设 读者 有 以 下 知识 : 
e。 基本 的 编程 经 验 


e Web 程 序 的 基础 技术 (HTTP, HTML) 
e UNIX ADT 


7.2. 开始 


首先 ， 要 有 一 个 Linux, OS X, or FreeBSD 和 有 系统 ， 可 以 运行 go 程序 。 如 果 没 有 的 话 ， 
可 以 安装 一 个 虚拟 机 (如 VirtualBox) 或 者 Virtual Private Server. 


安装 Go 环境 : (请 参考 Installation Instructions). 


创建 一 个 新 的 目录 ， 并 且 进 入 该 目录 : 


$ mkdir ~/gowiki 
$ cd ~/gowiki 


创建 一 个 wiki.go 文 件 ， 用 你 喜欢 的 编辑 器 打开 ， 然 后 添加 以 下 代码 : 


package main 


import ( 
"Fmt" 
"io/ioutil" 
"os" 

) 


我 们 从 go 的 标准 库 导 人 fmt, ioutil 和 os 包 。 以 后 ， 当 实现 其 他 功能 时 ， 我 们 会 根据 
需要 导 人 更 多 包 。 


7.3. 数据 结构 


我 们 先 定 义 一 个 结构 类 型 ， 用 于 保存 数据 。wiki 系 统 由 一 组 互联 的 wiki 页 面 组 成 ， 每 
个 wiki 页 面包 含 内 容 和 标题 。 我 们 定义 wiki 页 面 为 结构 page， WE: 


type page struct { 
title string 
body []byte 


类 型 byte 表示 一 个 byte slice. (参考 Effective Go 了 解 slices 的 更 多 信息 ) 成 员 body 
之 所 以 定义 为 [byte 而 不 是 string 类 型 ， 是 因为 [byte 可 以 直接 使 用 io 包 的 功能 。 


结构 体 page 描 述 了 一 个 页 面 在 内 存 中 的 存储 方式 。 但 是 ， 如 果 要 将 数据 保存 到 磁盘 
的 话 ， 还 需要 给 page 类 型 增加 save 方 法 : 


func (p *page) save() os.Error { 
filename := p.title + ".txt" 
return ioutil.WriteFile(filename, p.body, 0600) 


类 型 方法 的 签名 可 以 这 样 解读 : "save 为 page 类 型 的 方法 ， 方法 的 调用 者 为 page 类 
型 的 指针 变量 p。 该 成 员 函 数 没 有 人 参数， 返回 值 为 0s.Error， 表 示 错 误 信 息 。” 


该 方法 会 煌 page 结 构 的 body 部 分 保存 到 文本 文件 中 。 为 了 简单 ， 我 们 用 title 作 为 文 
本 文件 的 名 字 。 


方法 save 的 返回 值 类 型 为 os.Error， 对 应 WriteFile (标准 库 范 数 ， 将 byte slice 写 到 
文件 中 ) 的 返回 值 。 通 过 返回 os.Error 值 ， 可 以 判断 发 生 错误 的 类 型 。 如 果 没 有 错 
误 ， 那 么 返回 nil( 指 针 、 接 口 和 其 他 一 些 类 型 的 需 值 )。 


WriteFile 的 第 三 个 参数 为 八进制 的 0600， 表 示 仅 当前 用 户 拥 有 新 创建 文件 的 读 写 权 
限 。( 参 考 Unix 手 册 open(2) ) 


下 面 的 沙 数 加 载 一 个 页 面 : 


func loadPage(title string) *page { 
filename := title + ".txt" 
body, _ := ioutil.ReadFile( filename) 
return &page{title: title, body: body} 


函数 loadPage 根 据 页 面 标题 从 对 应 文件 读 取 页 面 的 内 容 ， 并 且 构 造 一 个 新 的 page 
变量 一 一 对 应 一 个 页 面 。 





goPNe 〈 以 及 成 员 方法 ) 可 以 返回 多 个 值 。 标 准 库 中 的 io.ReadFile 在 返回 []byte 
的 同时 还 返回 oS.Error 类 型 的 错误 信息 。 前 面 的 代码 中 我 们 用 下 划 线 “丢弃 了 错误 


信息 。 


但 是 ReadFile 可 能 会 发 生 错 误 ， 例 如 请 求 的 文件 不 存在 。 因 此 ， 我 们 给 函数 的 返回 
值 增 加 一 个 错误 信息 。 


func loadPage(title string) (*page, os.Error) { 


filename := title + ".txt" 
body, err := ioutil.ReadFile(filename) 
if err != nil { 


return nil, err 


return &page{title: title, body: body}, nil 


现在 调用 者 可 以 检测 第 二 个 返回 值 ， 如 果 为 nil 就 表示 成 功 装载 页 面 。 否 则 ， 调 用 者 
可 以 得 到 一 个 os.Error 对 象 。 (关于 错误 的 更 多 信息 可 以 参考 os package 
documentation) 


现在 ， 我 们 有 了 一 个 简单 的 数据 结构 ， 可 以 保存 到 文件 中 ， 或 者 从 文件 加 载 。 我 们 
创建 一 个 main 函 数 ， 测 试 相关 功能 。 


func main() { 
pl := &page{title: "TestPage", body: []byte("This is a sample 
pi.save() 
p2, _ := loadPage("TestPage" ) 
fmt .Println(string(p2.body) ) 
} 


编译 后 运行 以 上 程序 的 话 ， 会 创建 一 个 TestPage.txt 文 件 ， 用 于 保存 p1 对 应 的 页 面 
内 容 。 然 后 ， 从 文件 读 取 页 面 内 容 到 p2， 并 且 将 p2 的 值 打印 到 屏幕 。 
可 以 用 类 似 以 下 命令 编译 运行 程序 : 





$ 8g wiki.go 

$ 81 wiki.8 

$ ./8.out 

This is a sample page. 


( 命 合 8g 和 8| 对 应 GOARCH=386。 如 果 是 amd64 系 统 ， 可 以 用 6g 和 61) 
点 击 这 里 查看 我 们 当前 的 代码 。 


7.4. 使 用 http 包 


下 面 是 一 个 完整 的 web server 例 子 


package main 


import ( 
"Fmt" 
"http" 


) 


func handler(w http.Responsewriter, r *http.Request) { 
fmt.Fprintf(w, "Hi there, I love %s!", r.URL.Path[1:]) 


} 


func main() { 
http.HandleFunc("/", handler) 
http.ListenAndServe(":8080", nil) 


fEmaine 2, http.HdandleFuncik EMS 344R A R A KAY XBRL H handler. 


然后 调用 http.ListenAndServe， 在 8080 端 口 开 始 监听 (第 二 个 参数 暂时 可 以 忽 
i) 。 然 后 程序 将 阻塞 ， 直 到 退出 。 


画 数 handler 为 http.HandlerFunc 类 型 ， 它 包含 http.Conn 和 http.Request 两 个 类 型 的 
参数 。 


其 中 http.Conn 对 应 服务 器 的 http 连 接 ， 我 们 可 以 通过 它 向 客户 端 发 送 数据 。 


类 型 为 http.Request 的 参数 对 应 一 个 客户 端 请 求 。 其 中 r.URL.Path 为 请 求 的 地 址 ， 
是 一 个 string 类 型 变量 。 我 们 用 [1:] 在 Path 上 创建 一 个 slice， 对 应 "/" 之 后 的 路 径 


o 


启动 该 程序 后 ， 通 过 浏览 器 访问 以 下 地 址 : 


a 


http://localhost :8080/monkeys 


会 看 到 以 下 输出 内 容 : 


Hi there, I love monkeys! 


7.5. 基于 http 提 供 wiki 页 面 
要 使 用 http 包 ， 先 将 其 导入 : 


import ( 
"Fmt" 
"http" 
"io/ioutil" 
"os" 

) 


然后 创建 一 个 用 于 浏览 wiki 的 函数 : 


const lenPath = len("/view/") 


func viewHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
p, _ := loadPage(title) 
fmt.Fprintf(w, "<hi>%s</hi><div>%s</div>", p.title, p.body) 
} 


HE a ee | 


首先 ， 这 个 函数 从 r.URL.Path( 请 求 URL 的 path 部 分 ) 中 解析 页 面 标题 。 全 局 常量 
lenPath 保 存 "/view/" 的 长 度 ， 它 是 请 求 路 径 的 前 级 部 分 。Path 总 是 以 "/view/" 开 头 ， 
去 掉 前 面 的 6 个 字符 就 可 以 得 到 页 面 标题 。 


然后 加 载 页 面 数据 ， 格 式 化 为 简单 的 HTML 字 符 串 ， 写 到 c 中 ，c 是 一 个 http.Conn 类 
型 的 参数 。 


注意 这 里 使 用 下 划 线 ″ "忽略 loadPage 的 os.Error 返 回 值 。 这 不 是 一 种 好 的 做 法 ， 此 
处 是 为 了 保持 简单 。 我 们 将 在 后 面 考虑 这 个 问题 。 


为 了 使 用 这 个 处 理 了 范 数 (handler)， 我 们 创建 一 个 main 函 数 。 它 使 用 viewHandler 初 
始 化 http， 把 所 有 以 /view/ 开 头 的 请 求 转发 给 viewHandler 处 理 。 


func main() { 
http.HandleFunc("/view/", viewHandler) 
http.ListenAndServe(":8080", nil) 


点 击 这 里 查看 我 们 当前 的 代码 。 
让 我 们 创建 一 些 页 面 数据 (例如 as test.txt) ， 编 译 ， 运 行 。 


$ echo "Hello world" > test.txt 
$ 8g wiki.go 

$ 81 wiki.8 

$ ./8.out 


当 服 务 器 运行 的 时 候 ， 访 问 http://localhost:8080/view/test 将 显示 一 个 页 面 ， 标 题 
为 “test"， 内 容 为 “Hello world”, 


7.6. 2034 n E 


编辑 功能 是 wiki 不 可 缺少 的 。 现 在 ， 我 们 创建 两 个 新 的 处 理 函 数 (handler) : 
editHandler 显 示 "edit page" 表 单 (form)，saveHandler 保 存 表单 (form) 中 的 数据 。 


首先 ， 将 他 们 添加 到 main() 函 数 中 : 


func main() { 
http.HandleFunc("/view/", viewHandler) 
http.HandleFunc("/edit/", editHandler) 
http.HandleFunc("/save/", saveHandler) 
http.ListenAndServe(":8080", nil) 


函数 editHandler 加 载 页 面 (或 者 ， 如 果 页 面 不 存在 ， 创 建 一 个 空 page 结构 ) 并 且 显 示 
为 一 个 HTML 表 单 (form)。 


func editHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
p, err := loadPage(title) 
if err != nil { 
p = &page{title: title} 


fmt.Fprintf(w, "<hi>Editing %s</hi>"+ 
"<form action=\"/save/%s\"_ method=\"POST\">"+ 
"<textarea name=\"body\">%s</textarea><br>"+ 
"<input type=\"submit\" value=\"Save\">"+ 
"</form>", 
p.title, p.title, p-.body) 
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7.7. template 包 


template 包 是 GO 标准 库 的 一 个 部 分 。 我 们 使 用 template 将 HTML 存 放 在 一 个 单独 的 
文件 中 ， 可 以 更 改编 辑 页 面 的 布局 而 不 用 修改 相关 的 GO 代码 。 


首先 ， 我 们 必须 将 template 添 加 到 导入 列表 : 


import ( 
"http" 
"io/ioutil" 
"os" 
"template" 
) 


创建 一 个 包含 HTML 表 单 的 模板 文件 。 打 开 一 个 名 为 edit.html 的 新 文件 ， 添 加 下 面 
的 行 : 

<hi>Editing {title}</h1> 

<form action="/save/{title}" method="POST"> 

<div><textarea name="body" rows="20" cols="80">{body|htm1}</texté 


<div><input type="submit" value="Save"></div> 
</form> 


4 _ z 
修改 editHandler， 用 模板 替代 硬 编码 的 HTML。 





func editHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
p, err := loadPage(title) 
if err != nil { 
p = &page{title: title} 


} 
t, _ := template.ParseFile("edit.html", nil) 
t.Execute(p, w) 


-Xtemplate.ParseFileizAXedit.htmINJAR, iREl*template. Template 类 型 的 数 
据 。 


方法 t.Execute 用 p.title 和 p.body 的 值 替 换 模板 中 所 有 的 {title} 和 {body}， 并 且 把 结果 
写 到 http.Conn。 


注意 ， 在 上 面 的 模板 中 我 们 使 用 {body|html}。|html 部 分 请 求 模板 引擎 在 输出 body 的 
值 之 前 ， 先 将 它 传 到 html 格 式 化 器 (formatter)， 转 义 HTML 字 符 (比如 用 &aamp;gt; 
替换 >) 。 这 样 做 ， 可 以 阻止 用 户 数据 破坏 表单 HTML。 


既然 我 们 删除 了 fmt.Sprintf 语 句 ， 我 们 可 以 删除 导入 列表 中 的 "fmt"。 
使 用 模板 技术 ， 我 们 可 以 为 viewHandler 创 建 一 个 模板 ， 命 名 为 view.html。 


<h1>{title}</h1> 
<p>[<a href="/edit/{title}">edit</a>]</p> 


<div>{body}</div> 


修改 viewHandler : 


func viewHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
p, _ := loadPage(title) 
t, _ := template.ParseFile("view.html", nil) 
t.Execute(p, w) 


Hae, Hah ee (handler) HEA LESSEN RRs, BAL 
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func viewHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
p, _ := loadPage(title) 
renderTemplate(w, "view", p) 


} 


func editHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
p, err := loadPage(title) 
if err != nil { 
p = &page{title: title} 


renderTemplate(w, "edit", p) 


} 

func renderTemplate(w http.Responsewriter, tmpl string, p *page) 
t, _ := template.ParseFile(tmpl+".html", nil) 
t.Execute(p, w) 

} 
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7.8. 义理 不 存在 的 页 面 


当 你 访问 /view/APageThatDoesntExist 的 时 候 会 发 生 什 么 ?程序 将 会 骨 溃 为 我 


ZS AA Yio 
们 忽略 了 loadPage 返 回 的 错误 。 请 求 页 不 存在 的 时 候 ， 应 该 重 定向 客户 端 到 编辑 
页 ， 这 样 新 的 页 面 将 会 创建 。 


func viewHandler(w http.Responsewriter, r *http.Request, title si 
p, err := loadPage(title) 


if err != nil { 
http.Redirect(w, r, "/edit/"+title, http.StatusFound) 
return 

} 


renderTemplate(w, "view", p) 





函数 http.Redirect 添 加 HTTP 状 态 码 http.StatusFound (302) 和 报头 Location 到 HTTP 
响应 。 


7.9. 储存 页 面 
EeesaveHandler x FER % $2, 


func saveHandler(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
body := r.FormValue("body" ) 
p := &page{title: title, body: []byte(body) } 
p.save() 
http.Redirect(w, r, "/view/"+title, http.StatusFound) 


页 面 标题 (在 URL 中 ) 和 表单 中 唯一 的 字段 ，body， 储 存在 一 个 新 的 page 中 。 然 后 
调用 save() 方 法 将 数据 写 到 文件 中 ， 并 且 将 客户 重 定向 到 /view/ 页 面 。 


FormValue 返 回 值 的 类 型 是 string， 在 将 它 添加 到 page 结 构 前 ， 我 们 必须 将 其 转换 
为 [byte 类 型 。 我 们 使 用 []byte(body) 执 行 转换 。 


7.10. 错误 处 理 


在 我 们 的 程序 中 ， 有 几 个 地 方 的 错误 被 忽略 了 。 这 是 一 种 很 糟糕 的 方式 ， 特 别 是 在 
错误 发 生 后 ， 程 序 会 月 溃 。 更 好 的 方案 是 义理 错误 并 返回 错误 消息 给 用 户 。 这 样 
做 ， 当 错误 发 生 后 ， 服 务 器 可 以 继续 运行 ， 用 户 也 会 得 到 通知 。 


首先 ， 我 们 处 理 renderTemplate 中 的 错误 : 


func renderTemplate(w http.ResponseWriter, tmpl string, p *page) 
t, err := template.ParseFile(tmpl+".html", nil) 


if err != nil { 
http.Error(w, err.String(), http.StatusInternalServerErr< 
return 

} 

err = t.Execute(p, w) 

if err != nil { 


http.Error(w, err.String(), http.StatusInternalServerErr< 





函数 http.Error 发 送 一 个 特定 的 HTTP 响 应 码 〈 在 这 里 表示 "Internal Server Error”) 
和 错误 消息 。 


现在 ， 让 我 们 修复 saveHandler : 


func saveHandler(w http.Responsewriter, r *http.Request, title si 
body := r.FormValue("body" ) 
p := &page{title: title, body: []byte(body) } 


err := p.save() 

if err != nil { 
http.Error(w, err.String(), http.StatusInternalServerErr« 
return 


http.Redirect(w, r, "/view/"+title, http.StatusFound) 





p.save() 中 发 生 的 任何 错误 都 将 报告 给 用 户 。 


7.11. 模板 缓存 


代码 中 有 一 个 低 效 率 的 地 方 : 每 次 显示 一 个 页 面 ，renderTemplate 都 要 调用 
ParseFile。 更 好 的 做 法 是 在 程序 初始 化 的 时 候 对 每 个 模板 调用 ParseFile 一 次 ， 将 
结果 保存 为 *Template 类 型 的 值 ， 在 以 后 使 用 。 


首先 ， 我 们 创建 一 个 全 局 map， 命 名 为 templates。templates 用 于 储存 *Template 类 
型 的 值 ， 使 用 string 索 引 。 


， 我 们 创建 一 个 init 男 数 ，init 画 数 会 在 程序 初始 化 的 时 候 调 用 ， 在 main 轴 数 之 
a. 函数 template.MustParseFile 是 ParseFile 的 一 个 封装 ， 它 不 返回 错误 码 ， 而 是 
在 错误 发 生 的 时 候 抛 出 (panic) 一 个 昔 误 。 抛 出 错误 (panic) 在 这 里 是 合适 的 ， 如 果 模 
板 不 能 加 载 ， 程 序 唯一 能 做 的 有 意义 的 事 就 是 退出 。 


func init() { for _, tmpl := range []string{"edit", "view"} { ter 





使 用 带 range 语 名 的 for 特 环 访 问 一 个 常量 数组 中 的 每 一 个 元 素 ， 这 个 常量 数组 中 包 
含 了 我 们 想 要 加 载 的 所 有 模板 的 名 称 。 如 果 我 们 想 要 添加 更 多 的 模板 ， 只 要 把 模板 
名 称 添 加 的 数组 中 就 可 以 了 。 


修改 renderTemplate 函 数 ， 在 templates 中 相应 的 Template 上 调用 Execute 方 法 : 


func renderTemplate(w http.ResponseWriter, tmpl string, p *page) 
err := templates[tmpl].Execute(p, w) 
if err != nil { 
http.Error(w, err.String(), http.StatusInternalServerErr< 





7.12. 3 


你 可 能 已 经 发 现 ， 程 序 中 有 一 个 严重 的 安全 漏洞 : 用 户 可 以 提供 任意 的 路 径 在 服务 
eee eee 为 了 消除 这 个 问题 ， 我 们 使 用 正则 表达 式 验 证 页 面 的 标题 。 


添加 "regexp" 到 导入 列表 。 然 后 创建 一 个 全 局 变量 存储 我 们 的 验证 正则 表达 


函数 regexp.MustCompile 解 析 并 且 编 译 正则 表达 式 ， 返 回 一 个 regexp.Regexp 对 
象 。 和 template.MustParseFile 类 似 ， 当 表达 式 编 译 错误 时 ，MustCompile 抛 出 一 
错误 ， E 
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func getTitle(w http.Responsewriter, r *http.Request) (title str: 
title = r.URL.Path[lenPath: ] 
if !titleValidator.MatchString(title) { 
http.NotFound(w, r) 
err = os.NewError("Invalid Page Title") 


} 


return 


Aoo ëg 


如 果 标 题 有 效 ， 它 返回 一 个 nil 错 误 值 。 如 果 无 效 ， 它 写 "404 Not Found"# Fl 
HTTP 连 接 中 ， 并 且 返 回 一 个 错误 对 象 。 


修改 所 有 的 处 理 画 数 ， 使 用 getTitle 获 取 页 面 标题 : 





func viewHandler(w http.Responsewriter, r *http.Request) { 

title, err := getTitle(w, r) 

if err != nil { 
return 

} 

p, err := loadPage(title) 

if err != nil { 
http.Redirect(w, r, "/edit/"+title, http.StatusFound) 
return 

} 


renderTemplate(w, "view", p) 


} 


func editHandler(w http.Responsewriter, r *http.Request) { 
title, err := getTitle(w, r) 


if err != nil { 
return 
} 
p, err := loadPage(title) 
if err != nil { 


p = &page{title: title} 
} 


renderTemplate(w, "edit", p) 


} 


func saveHandler(w http.Responsewriter, r *http.Request) { 
title, err := getTitle(w, r) 
if err != nil { 
return 
} 


body := r.FormValue("body") 
p := &page{title: title, body: []byte(body)} 
err = p.save() 


if err != nil { 
http.Error(w, err.String(), http.StatusInternalServerErr« 
return 

} 


http.Redirect(w, r, "/view/"+title, http.StatusFound) 
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码 封装 成 一 个 画 数 ， 应 该 怎么 做 ? GO 的 函数 文本 提供 了 强大 的 抽象 能 力 ， 可 以 帮 
我 们 做 到 这 点 。 


首先 ， 我 们 重 写 每 个 外 理 函 数 的 定义 ， 让 它们 接受 标题 字符 串 : 


定义 一 个 封装 函数 ， 接 受 上 面 定义 的 函数 类 型 ， 返 回 http.HandlerFunc (可 以 传送 
给 函数 http.HandleFunc) 。 


func makeHandler(fn func (http.ResponseWriter, *http.Request, sti 
return func(w http.Responsewriter, r *http.Request) { 
// Here we will extract the page title from the Request, 
// and call the provided handler 'fn' 





返回 的 函数 称 为 闭 包 ， 因 为 它 包 含 了 定义 在 它 外 面 的 值 。 在 这 里 ， 变 量 
fn (makeHandler 的 唯一 参数 ) 被 闭 包 包含 。fn 是 我 们 的 义理 函数 ，save、edit、 或 
View。 


我 们 可 以 把 getTitle 的 代码 复制 到 这 里 (有 一 些小 的 变动 ) 


func makeHandler(fn func(http.Responsewriter, *http.Request, str: 
return func(w http.Responsewriter, r *http.Request) { 
title := r.URL.Path[lenPath: ] 
if !titleValidator.MatchString(title) { 
http.NotFound(w, r) 
return 


} 
fn(w, r, title) 
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http.Request (因此 ， 它 是 http.HandlerFunc) 。 闭 包 从 请 求 路 径 解 析 title， 使 用 
titleValidator 验 证 标题 。 如 果 title 无 效 ， 使 用 函数 http.NotFound 将 错误 写 到 Conn。 
如 果 title 有 效 ， 封 装 的 处 理 画 数 fn 将 被 调用 ， 参 数 为 Conn, Request, 和 title。 


在 main 画 数 中 ， 我 们 用 makeHandler 封 装 所 有 处理 函数 : 


func main() { 
http.HandleFunc("/view/", makeHandler(viewHandLer ) ) 
http.HandleFunc("/edit/", makeHandler(editHandLer ) ) 
http.HandleFunc("/save/", makeHandler(saveHandLer ) ) 
http.ListenAndServe(":8080", nil) 


最 后 ， 我 们 可 以 删除 处 理 函 数 中 的 getTitle， 让 处 理 函 数 更 简单 。 


func viewHandler(w http.Responsewriter, r *http.Request, title si 
p, err := loadPage(title) 
if err != nil { 
http.Redirect(w, r, "/edit/"+title, http.StatusFound) 
return 


renderTemplate(w, "view", p) 


} 


func editHandler(w http.Responsewriter, r *http.Request, title si 
p, err := loadPage(title) 
if err != nil { 
p = &page{title: title} 


renderTemplate(w, "edit", p) 


} 


func saveHandler(w http.Responsewriter, r *http.Request, title si 
body := r.FormValue("body" ) 
p := &page{title: title, body: []byte(body) } 


err := p.save() 

if err != nil { 
http.Error(w, err.String(), http.StatusInternalServerErr< 
return 

} 


http.Redirect(w, r, "/view/"+title, http.StatusFound) 
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7.14. 试 试 |! 

点 击 这 里 查看 最 终 的 代码 

重新 编译 代码 ， 运 行程 序 : 
$ 8g wiki.go 


$ 81 wiki.8 
$ ./8.o0ut 


访问 http:/Wlocalhost:8080/view/ANewPage 将 会 出 现 一 个 编辑 表单 。 你 可 以 输入 一 
些 文 版 ， 点 击 “Save”， 重 定向 到 新 的 页 面 。 


7.15. 其 他 任务 


这 里 有 一 些 简单 的 任务 ， 你 可 以 自己 解决 : 


。 把 模板 文件 存放 在 tmpl/ 目 录 ， 页 面 数据 存放 在 data/ 目 录 。 

。 增加 一 个 处 理 函 数 (handler)， 将 对 根 目 录 的 请 求 重 定 向 到 /view/FrontPage。 

。 修饰 页 面 模板 ， 使 其 成 为 有 效 的 HTML 文 件 。 添 加 CSS 规 则 。 

。 实现 页 内 链接 。 将 [PageName] 修 改 为 <a 
href="/view/PageName">PageName</a>。( 提 示 : 可 以 使 用 
regexp.ReplaceAlIFunc 达 到 这 个 效果 ) 


8. 针对 C++ 程序 员 指 南 

Go 和 C 十 十 一 样 ， 也 是 一 门 系统 编程 语言 。 该 文档 主要 面向 有 C 十 十 经 验 的 程序 开 
RAR. 它 讨 论 了 Go 和 C 十 十 的 不 同 之 处 ， 当 然 也 讨论 了 一 些 相 似 之 处 。 

如 果 是 想 要 Go 的 概要 介绍 ， 请 参考 Go tutorial 和 Effective Go, 

关于 语言 细节 的 正式 说 明 ， 请 参考 Go spec. 


8.1. 概念 差异 


Go 没有 支持 构造 和 析 构 的 class 类 型 ， 也 没有 继承 和 虚 函 数 的 概念 。 但 是 go 提 
供 接 口 interfaces 支持 ， 我 们 可 以 把 接口 看 作 是 C++ 中 模板 类 似 的 技术 。 

Go 提供 垃圾 内 存 回 收 支 持 。 我 们 没有 必要 显 式 释 放 内 存 ，go 的 运行 时 系统 会 
帮 有 我 们 收集 垃圾 内 存 。 

Go 中 有 指针 ， 但 是 没有 指针 算术 。 因 此 ， 你 不 可 能 通过 指针 以 字 节 方式 来 通 历 
一 个 字符 串 。 数组 一 个 普通 类 型 变量 。 当 用 数组 作为 参数 调用 西数 时 ， 将 会 复 
制 整个 数组 。 当 然 ，Go 语 言 中 一 般 用 切片 (slices) 代替 数组 作为 参数 ， 切 片 
因此 传递 的 是 数组 的 地 址 。 切 片 在 后 面 会 详细 


Aa ct ERATE. 并 且 字 符 串 创建 后 就 不 能 修改 。 

内 建 hash 表 支持 ， 术 语 叫 字典 (map) 。 

语言 本 身 提供 并 发 和 管道 通讯 功能 ， 细 节 在 后 面 会 讨论 。 

有 少数 类 型 是 通过 引用 传递 (字典 和 管道 ， 将 在 后 面 讨 论 ) 。 也 就 是 说 ， 将 字 
典 传递 给 一 个 函数 不 会 复制 整个 字典 ， 而 且 丽 数 对 字典 的 修改 会 影响 到 本 村 数 调 
用 者 的 字典 数据 。 这 和 C++ 中 引用 概念 类 似 。 

Go 不 使 用 头 文件 。 每 个 源 文 件 都 被 定义 在 特定 的 包 package 中 ， 在 包 中 以 大 写 
字母 定义 的 对 象 (PIKE, SS, 28, WARS) 对 外 是 可 见 的 ， 可 以 被 别 
的 代码 导入 使 用 。 

Go 不 会 作 隐 式 类 型 转换 。 如 果 在 不 同类 型 之 间 赋 值 ， 必 须 强 制 转换 类 型 。 

Go 不 支持 范 数 重 载 ， 也 不 支持 运算 符 定 义 。 

Go 不 支持 const 和 volatile 修饰 符 。 

Go 使 用 nil 表 示 无 效 的 指针 ，C++ 中 使 用 NULL 或 0 表示 空 指针 。 


8.2. 语法 


Go 中 变量 的 声明 语法 和 C++ 相反 。 定 义 变 量 时 ， 先 写 变 量 的 名 字 ， 然 后 是 变量 的 类 
型 。 这 样 不 会 出 现 像 C++ 中 ， 类 型 不 能 匹配 后 面 所 有 变量 的 情况 (指针 类 型 ) 。 
而 且 语法 清晰 ， 便 于 阅读 。 


Go C++ 

var v1 int // int v1; 

var v2 string // const std::string v2; (approximate: 
var v3 [10]int // int v3[10]; 

var v4 []int // int* v4; (approximately 近似 等 价 ) 
var v5 struct { f int } // struct { int f; } v5; 

var v6 *int // int* v6; (but no pointer arithmetic 
var v7 map[string]int // unordered_map<string, int>* v7; (ay 
var v8 func(a int) int 77 int (*v8)(int a); 


BT 


变量 的 声明 通常 是 从 某 些 关键 字 开 始 ， 例 如 var， func，const 或 type。 对 于 类 型 的 
专 有 方法 定义 ， 在 变量 名 前 面 还 要 加 上 对 应 该 方法 发 类 型 对 象 变量 ， 细 节 清 参考 
discussion of interfaces。 


你 也 可 以 在 关键 字 后 面 加 括号 ， 这 样 可 以 同时 定义 多 个 变量 。 





var ( 

i int 

m float 
) 


When declaring a function, you must either provide a name for each parameter or 
not provide a name for any parameter; you can't omit some names and provide 
others. You may group several names with the same type: 


定义 函数 的 时 候 ， 你 可 以 指定 每 个 参数 的 名 字 或 者 不 指定 任何 参数 名 字 ， 但 是 你 不 
能 只 指定 部 分 画 数 参数 的 名 字 。 如 果 是 相信 的 参数 是 相同 的 关 型 ， 也 可 以 统一 指定 
类 型 。 


func f(i, j, k int, s, t string) 


对 于 变量 ， 可 以 在 定时 进行 初始 化 。 对 于 这 种 情况 ， 我 们 可 以 省 略 变量 的 类 型 部 
分 ， 因 为 Go 编译 器 可 以 根据 初始 化 的 值 推导 出 变量 的 类 型 。 


var v = *p 


如 果 变 量 定义 时 没有 初始 化 ， 则 必须 指定 类 型 。 没 有 显 式 初始 化 的 变量 ， 会 被 自动 
初始 化 为 空 的 值 ， 例如 0，nil 等 。Go 不 存在 完全 未 初始 化 的 变量 。 


用 := 操作 符 ， 还 有 更 简短 的 定义 语法 : 


和 下 面 语句 等 价 : 


var vi = v2 


Go 还 提供 多 个 变量 同时 赋值 : 

ye Al elie Sl // Swap i and j. 
函数 也 可 以 返回 多 个 值 ， 多 个 返回 值 需要 用 括号 括 起 来 。 返 回 值 可 以 用 一 个 等 于 符 
SRA 多 个 变量 。 


PUNE EO eT eli Eee gdh LN te etd: 
vi, v2 = f() 


Go 中 使 用 很 少 的 分 号 ， 虽 然 每 个 语句 之 间 实 际 上 是 用 分 号 分 割 的 。 因 为 ，go 编 译 
器 会 在 看 似 完整 的 语句 末尾 自动 添加 分 号 (具体 细节 清 参 考 Go 语 言 手册 ) 。 当 
然 ， 自 动 添加 分 号 也 可 能 带 来 一 些 问题 。 例 如 : 


func g() 
{ 
} 


// INVALID 


在 g() 函 数 后 面 会 被 自动 添加 分 号 ， 导 致 画 数 编译 出 错 。 下 面 的 代码 也 有 类 似 的 问 
Rl: 
Ir T 


} 
else { // INVALID 


在 第 一 个 花 括 号 } 的 后 面 会 被 自动 添加 分 号 ， 导 致 else 语 句 出 现 语法 错误 。 

分 号 可 以 用 来 分 割 语句 ， 你 仍然 可 以 安装 C++ 的 方式 来 使 用 分 号 。 不 过 Go 语言 中 ， 
常常 省 略 不 必要 的 分 号 。 只 有 在 循环 语句 的 初始 化 部 分 ， 或 者 一 行 写 多 个 语句 的 
时 候 才 是 必须 的 。 


继续 前 面 的 问题 。 我 们 并 不 用 担心 因为 花 括号 的 位 置 导致 的 编译 错误 ， 因 此 我 们 可 
以 用 gofmt 来 排版 程序 代码 。 gofmt 工具 总 是 可 以 将 代码 排版 成 统一 的 风格 。 
While the style may initially seem odd, it is as good as any other style, and 
familiarity will lead to comfort. 


当 用 指针 访问 结构 体 的 时 候 ， 我 们 用 .代替 -> 语法 。 因此 ， 用 结构 体 类 型 和 结构 体 
指针 类 型 访问 结构 体 成 员 的 语法 是 一 样 的 。 


type myStruct struct { i int } 

var v9 myStruct // v9 has structure type 

var p9 *myStruct // p9 is a pointer to a structure 
f(v9.i, p9.i) 


Go 不 要 求 在 if 语 句 的 条 件 部 分 用 小 括 弧 ， 但 是 要 求 if 后 面 的 代码 部 分 必须 有 花 括 
弧 。 类似 的 规则 也 适用 于 for 和 switch 等 语句 。 


ifa<b{f()} // Valid 
if (a< b) 4{f()} // Valid (condition is a parenthesi: 
if (a < b) f() // INVALID 


for i = 0; i < 10; i++ {} // Valid 
for (i = 0; i < 10; i++) {} // INVALID 


<] Eg 
Go 语言 中 没有 while 和 do/while 循 环 语句 。 我 们 可 以 用 只 有 一 个 条 件 语句 的 for 来 代 
蔡 while 循 环 。 如 果 省 略 for 的 条 件 部 分 ， 则 是 一 个 无 限 循环 。 


Go 增加 了 带 标 号 的 break 和 continue 语 法 。 不 过 标号 必须 是 针对 for，switch 或 
select 代 码 段 的 。 


对 于 switch 语 句 ，case 匹 配 后 不 会 再 继续 匹配 后 续 的 部 分 。 对 于 没有 任何 匹配 的 情 
况 ， 可 以 用 fallthrough 语句 。 





switch i { 
case 0: // empty case body 
case 1: 
f() // f is not called when i == 0! 


caseg Dik LSE: 


switch i { 
case 0, 1: 

f() // f is called if i == 0 || i == 1. 
t 


case 语 句 不 一 定 必须 是 整数 或 整数 常量 。 如 果 省 略 switch 的 要 匹配 的 值 ， 那 么 case 
可 以 是 任意 的 条 件 语 言 。 


switch { 
case i < 0: 
F1() 
case i == 0: 
f2() 
case i > 0: 


f3() 
} 


++ 和 -- 不 再 是 表达 式 ， 它 们 只 能 在 语句 中 使 用 。 因 此 ， c = p++ 是 错误 的 。 语 名 
p++ 的 含义 也 完全 不 同 ， 在 go 中 等 价 于 (*p)++ 。 


defer 可 以 用 于 指定 函数 返回 前 要 执行 的 语句 。 


fd := open("filename") 
defer close(fd) // fd will be closed when this function ı 


Se) 





8.3. 音量 


Go 语言 中 的 常量 可 以 没有 固定 类 型 (untyped) 。 我 们 可 以 用 const 和 一 个 untyped 
类 型 的 初始 值 来 定义 untyped 常 量 。 如 果 是 untyped 常 量 ， 那么 常量 在 使 用 的 时 候 
会 根据 上 下 文 自动 进行 隐 含 的 类 型 转换 。 这 样 ， 可 以 更 自由 的 使 用 untyped 常 量 。 


var a uint 
f(a + 1) // untyped numeric constant "1" becomes typed as uint 


‘| ee E 
untyped 类 型 常量 的 大 小 也 没有 限制 。 只 有 在 最 终 使 用 的 地 方才 有 大 小 的 限制 。 





const huge = 1 << 100 
f(huge >> 98) 


Go 没有 枚 举 类 型 (enums) 。 作 为 代替 ， 可 以 在 一 个 独立 的 const 区 域 中 使 用 iota 
来 生成 递增 的 值 。 如 果 const 中 ， 常 量 没 有 初始 值 则 会 用 前 面 的 初始 化 表达 式 代 


o 


const ( 
red = iota // red == 0 
blue // blue == 1 
green // green == 2 


8.4. Slices( 切 片 ) 


切片 (slice) 底层 对 应 类 结构 体 ， 主 要 包含 以 下 信息 : 指向 数据 的 指针 ， 有 效 数 据 
的 数目 ， 和 总 的 内 存 空间 大 小 。 切片 支持 用 语法 获取 底层 数组 的 某 个 元 素 。 内 建 
的 len 方法 可 以 获取 切片 的 长 度 。 内 建 的 cap 返 回 切片 的 最 大 容量 。 


对 于 一 个 数组 或 另 一 个 切片 ， 我 们 用 al:J? 语 名 再 它 基础 上 创建 一 个 新 的 切片 。 这 
个 新 创建 的 切片 底层 引用 a (数组 或 之 前 的 另 一 个 切片 ) ， 从 数组 的 | 位 置 开始 ， 到 
数组 的 J 位 置 结 束 。 新 切片 的 长 度 是 J - |。 新 切片 的 容量 是 数组 的 容量 减 去 切片 在 
数组 中 的 开始 位 置 |。 我 们 还 可 以 将 数组 的 地 址 直接 赋 给 切片 : s = &a， 这 默认 是 
对 应 整个 数组 ， 和 这 个 语句 等 价 : s = a0:len(a)?。 


因此 ， 我 们 在 在 C++ 中 使 用 指针 的 地 方 用 切片 来 代替 。 例 如 ， 创 建 一 个 100?byte 类 
型 的 值 (100 个 字 节 的 数组 ， Ripe ASA). Be, ERM RYAN 
时 候 不 想 复制 整个 数组 (go 语言 PEA, KAEA 传 值 是 复制 的 ) ， 可 以 将 
画 数 参数 定 一 个 为 byte 切 片 类 型 ， 从 而 实现 只 传递 数组 地 址 的 目的 。 不 过 我 们 并 
不 需要 像 C++ 中 那样 传递 缓存 的 长 度 一 一 在 Go 中 它们 已 经 包含 在 切片 信息 中 了 。 


切片 还 可 以 应 用 于 字符 串 。 当 需要 将 有 录 个 字符 串 的 字 串 作为 你 新 字符 产 返回 的 时 候 
可 以 用 切片 代替 。 因为 go 中 的 字符 串 是 不 可 修改 的 ， 因 此 使 用 字符 串 切片 并 不 需要 
分 配 新 的 内 存 空间 。 





8.5. 构造 值 对 象 


Go 有 一 个 内 建 的 new 硒 数 ， 用 于 在 堆 上 为 任意 类 型 变量 分 配 一 个 空间 。 新 分 配 的 
内 存 会 内 自动 初始 化 为 0。 例如 ，new(int) 会 在 堆 上 分 配 一 个 整 型 大 小 的 空间 ， 然 
后 初始 化 为 0， 然 后 返回 *int 类 型 的 地 址 。 和 C++ 中 不 同 的 是 ，new 是 一 个 辑 数 而 
不 是 运算 符 ， 因 此 new int 用 法 是 错误 的 。 


对 于 字典 和 管道 ， 必 须 用 内 建 的 make 画 数 分 配 空间 。 对 于 没有 初始 化 的 字典 或 管 
道 变量 ， 会 被 自动 初始 化 为 nil。 调用 make(mapint?int) 返回 一 个 新 的 字典 空间 ， 类 
型 为 napint?int。 需 要 强调 的 是 ，make 返回 的 是 值 ， 而 不 是 指针 ! 与 此 对 应 的 
是 ， 字 典 和 管道 是 通过 引用 传递 的 。 对 于 make 分 配 字 典 空间 ， 还 可 以 有 一 个 可 选 
NN, 用 于 指定 字典 的 容量 。 如 果 是 用 于 创建 管道 ， 则 可 选 的 参数 对 应 管道 的 
缓冲 大 小 ， 默 认 0 表 示 不 缓存 。 


make 画 数 还 可 以 用 于 创建 切片 。 这 时 ， 会 在 堆 中 分 配 一 个 不 可 见 的 数组 ， 然 后 返 
回 对 这 个 数组 引用 的 切片 。 对 于 切片 ，make 画 数 除 了 一 个 指定 切片 大 小 的 参数 
外 ， 还 有 一 个 可 选 的 用 于 指定 切片 容量 的 参数 〈 最 多 有 3 个 参数 ) 。 例如 ， 
make(int, 10, 20)， 用 于 创建 一 个 大 小 是 10， 容 量 是 20 的 切片 。 当 然 ， 用 new 画 数 
也 能 实现 : new(20?int)0:10?。go 支 持 垃圾 内 存 自动 回收 ， 因 此 新 分 配 的 内 存 空 间 
没有 任何 切片 引用 的 时 候 ， 可 能 会 被 自动 释放 。 


8.6. Interfaces(## 0O) 


C++ 提供 了 class， 类 继承 和 模板 ， 类 似 的 go 语言 提供 了 接口 支持 。go 中 的 接口 和 
C++ 中 的 纯 虚 Be (RASERNA, SARERA) 类 似 。 在 Go 语言 中 ， 任 何 实现 
了 接口 的 函数 的 类 型 ， 都 可 以 看 作 是 接口 的 一 个 实现 。 类 型 在 实现 某 个 接口 的 时 
候 ， 不 需要 显 式 关联 该 接口 的 信息 。 接 口 的 实现 和 接口 的 定义 完全 分 离 了 。 


类 型 的 方法 和 普通 琅 数 定义 类似 ， 只 是 前 面 多 了 一 个 对 象 接收 者 receiver。 对 象 接 
受 者 和 C++ 中 的 this 指 针 类 似 。 


type myType struct { i int } 
func (p *myType) get() int { return p.i } 


方法 get 依 附 于 myType 类 型 。myType 对 象 在 函数 中 对 应 p。 


方法 在 命名 的 类 型 上 定义 。 如 果 ， 改 变 类 型 的 话 ， 那 么 束 是 针对 新 类 型 的 另 一 个 画 
数 了 。 


如 果 要 在 内 建 类 型 上 定义 方法 ， 则 需要 给 内 建 类 型 重新 指定 一 个 名 字 ， 然 后 在 新 指 
定名 字 的 类 型 上 定义 方法 。 新 定义 的 类 型 和 内 建 的 类 型 是 有 区 别 的 。 


type myInteger int 

func (p myInteger) get() int { return int(p) } // Conversion req 
func f(i int) { + 

var v myInteger 

// f(v) is invalid. 

// f(int(v)) is valid; int(v) has no defined methods. 


E 本 
把 方法 抽象 到 接口 : 





type myInterface interface { 
get() int 
set(i int) 


为 了 让 我 们 前 面 定 义 的 myType 满 足 接 口 ， 需 要 再 增加 一 个 方法 : 


func (p *myType) set(i int) { p.i = i } 


现在 ， 任 何以 mylnterface 类 型 作为 参数 的 函数 ， 都 可 以 用 *myType 类 型 传递 了 。 


func getAndSet(x myInterface) {} 


func f1() { 
var p myType 
getAndSet(&p) 
} 


以 C++ 的 观点 来 看 ， 如 果 把 mylnterface 看 作 一 个 纯 虚 基 类 ， 那 么 实现 了 set 和 get 
方法 的 *myType 自动 成 为 了 从 mylnterface 纯 虚 基 类 继承 的 子 类 了 。 在 Go 中 ， 一 个 
类 型 可 以 同时 实现 多 种 接口 。 
使 用 匿名 成 员 ， 我 们 可 以 模拟 C++ 中 类 的 继承 机 制 。 

type myChildType struct { myType; j int } 

func (p *myChildType) get() int { p.j++; return p.myType.get() } 
S T 


这 里 的 myChildType 可 以 看 作 是 myType 的 子 类 。 


func f2() { 
var p myChildType 
getAndSet(&p) 

} 


myChildType 类 型 中 是 有 set 方 法 的 。 在 go 中 ， 匿 名 成 员 的 方法 会 默认 被 提升 为 类 
型 本 身 的 方法 。 因为 myChildType 含 有 一 个 myType 类 型 的 匿名 成 员 ， 因 此 也 就 继 
承 了 myType 中 的 set 方 法 ， 另 一 个 get 方 法 则 相当 于 被 重 载 了 。 

不 过 这 和 C++ 也 不 是 完全 等 价 的 。 当 一 个 匿名 方法 被 调用 的 时 候 ， 方 法 对 应 的 类 型 
对 象 是 匿名 成 员 类 型 ， 并 不 是 当前 类 型 ! 换言之 ， 匿 名 成 员 上 的 方法 并 不 是 
C++ 中 的 虚 函 数 。 如 果 你 需要 模拟 虚 函 数 机 制 ， 那么 可 以 使 用 接口 。 

一 个 接口 类 型 的 变量 可 以 通过 接口 的 一 个 内 建 的 特殊 方法 转换 为 另 一 个 接口 类 型 变 
量 。 这 是 由 运行 时 库 动 态 完成 的 ， 和 C++ 中 的 dynamic_cast 有 些 类 似 。 但 是 在 Go 
语 计 中， 两 个 相互 转换 的 接口 类 型 之 间 并 不 需要 什么 信息 。 


type myPrintInterface interface { 
print() 


func f3(x myInterface) { 
x.(myPrintInterface).print() // type assertion to myPrir 
} 





向 myPrintlnterface 类 型 的 转换 是 动态 的 。 它 可 以 工作 在 底层 实现 了 print 方 法 的 变 


量 上 。 


因为 ， 这 里 动态 类 型 转换 机 制 ， 我 们 可 以 用 它 来 模拟 实现 C++ 中 的 模板 功能 。 这 里 
我 们 需要 定 一 个 最 小 的 接口 : 


type Any interface { } 


该 接口 可 以 持 有 任意 类 型 的 数据 ， 但 是 在 使 用 的 时 候 需 要 将 该 接口 变量 转换 为 需要 
的 类 型 。 因为 ， 这 里 类 型 转换 是 动态 实现 的 ， 因 此 ， 没 有 办 法 定义 像 C++ 中 的 内 联 
BRM, 类 型 的 验证 由 运行 时 库 完 成 ， 我们 可 以 调用 该 变量 类 型 支持 的 所 有 方法 。 


type iterator interface { 
get() Any 
set(v Any) 
increment() 
equal(arg *iterator) bool 


8.7. Goroutines 


Go 语言 中 使 用 go 可 以 启动 一 个 goroutine。goroutine 和 线程 的 概念 类 似 ， 和 程序 共 
享 一 个 地 址 空间 。 


goroutines 和 支持 多 路 并 发 草 组 系统 中 的 协 程 (coroutines) 类 似 ， 用 户 不 用 关心 具 
体 的 实现 细节 。 


func server(i int) { 
for { 
print(i) 
sys.sleep(10) 


} 
} 
go server(1) 
go server(2) 


(3 BF BA ZserverM A PA forts tis DA C++ while (true) 的 循环 类 似 。) 
Goroutines 资 源 开 销 小 ， 比 较 廉 价 。 
go 也 可 以 用 于 和 启动 新 定义 的 内 部 函 数 〈 闭 包 ) 为 Goroutines。 


var g int 
go func(i int) { 
Ss := 0 


人 


g=s 
}(1000) // Passes argument 1000 to the function literal. 


8.8. Channels( 管 道 ) 


管道 可 以 用 于 两 个 goroutines 之 间 的 通讯 。 我 们 可 以 用 管道 传递 任意 类 脂 的 变量 。 
Go 语言 中 管道 是 廉价 并 且 便 捷 的 。 二 元 操作 符 <- 用 于 向 管道 发 送 数据 。 一 元 操作 
符 <- 用 于 从 管道 接收 数据 。 在 函数 参数 中 ， 管 道 通 过 引用 传递 给 男 数 。 


虽然 go 语言 的 标准 库 中 提供 了 互 斥 的 支持 ， 但 是 我 们 也 可 以 用 一 个 单一 的 goroutine 
提供 对 变量 的 共享 操作 。 例如 ， 下 面 的 函数 用 于 管理 对 交 量 的 读 写 操作 。 


type cmd struct { get bool; val int } 
func manager(ch chan cmd) { 
var val int = 0 


for { 
c := <- ch 
if c.get { c.val = val ch <- c } 
else { val = c.val } 

} 


在 这 个 例子 中 ， 管 道 被 同时 用 于 输入 和 输出 。 但 是 当 多 个 goroutines 对 变量 操作 时 
可 能 导致 问题 : 对 管道 的 读 操作 可 能 读 到 的 是 请 求 命 令 。 解 决 的 方法 是 将 命 伟 和 数 
据 分 为 不 同 的 管道 。 


type cmd2 struct { get bool; val int; ch <- chan int } 
func manager2(ch chan cmd2) { 
var val int = 0 


for { 
c := <- ch 
if c.get { c.ch <- val } 
else { val = c.val } 

} 


这 里 掩饰 了 如 何 使 用 manager2 : 


func f4(ch <- chan cmd2) int { 
myCh := make(chan int) 
c := cmd2{ true, ©, myCh } // Composite literal syntax 
ch <- c 
return <-myCh 








9. 内 人 存 模型 


9.1. 简介 


GORA FRET LURE thE BE 
ARENEB 变量 的 读 操作 可 以 侦 测 到 今 一 个 goroutine 中 对 给 


9.2. Happens Before 


在 一 个 单独 的 goroutine 中 ， 变 量 的 读 和 写 操 作 顺 序 和 代码 所 写 的 顺序 一 致 。 因 此 ， 
在 变量 值 没 有 被 改变 的 时 候 ， 编译 器 和 义理 器 可 能 会 记录 变量 的 操作 顺序 。 但 

是 ， 这 种 先 验 性 的 顺序 记录 会 导致 在 两 个 不 同 的 goroutine 对 变量 操作 顺序 记录 有 
差别 。 例 如 ， 一 个 goroutine 执 行 a=1;b=2;， 但 是 在 另 一 个 goroutine 中 可 能 会 
现 感知 到 b 被 更 新 。 

为 了 解决 这 种 二 义 性 问题 ，Go 话 言 中 引进 一 个 happens before 的 概念 ， 它 用 于 描述 
对 内 存 操 作 的 先后 顺序 问题 。 如 果 事件 e1 happens before 事件 e2， 我 们 说 事件 


e2 happens aftere1, WR, 
事件 e1 does not happen before 事件 e2， 并 且 does not happen after e2, 


o 


对 于 一 个 单一 的 goroutine，happens before 的 顺序 和 代码 的 顺序 是 一 致 的 。 
如 果 能 满足 以 下 的 条 件 ， 一 个 对 变量 v 的 读 事 件 r 可 以 感知 到 另 一 个 对 变量 v 的 写 事 


件 w : 
1. 写 事 件 w happens before 读 事件 r。 


2. 没有 既 满 足 happens after w 同时 满 主 happens before r 的 对 变量 v 的 写 事 件 
Wo 


为 了 保证 读 事件 r 可 以 感知 对 变量 v 的 写 事 件 ， 我 们 首先 要 确保 w 是 变量 v 的 唯一 的 写 
事件 。 同 时 还 要 满足 以 下 条 件 : 


1. 写 事 件 w happens before 读 事件 r。 
2. 其 他 对 变量 v 的 访问 必须 happens before 写 事件 w 或 者 happens after 读 事 件 
Fo 


第 二 组 条 件 比 第 一 组 条 件 更 加 严格 。 因 为 ， 它 要 求 在 w 和 r 并 行 执 行 的 程序 中 不 能 再 
有 其 他 的 读 操 作 。 


对 于 在 单一 的 goroutine 中 两 组 条 件 是 等 价 的 ， 读 事件 可 以 确保 感知 到 对 变量 的 写 事 
件 。 但 是 ， 对 于 在 两 个 goroutines 共 享 变 量 v， 我 们 必须 通过 同步 事件 来 保证 
happens-before 条 件 〈 这 是 读 事件 感知 写 事 件 的 必要 条 件 ) 。 


将 变量 Vv 自动 初始 化 为 需 也 是 属于 这 个 内 存 操作 模型 。 
读 写 超 过 一 个 机 器 字 长 度 的 数据 ， 顺 序 也 是 不 能 保证 的 。 


9.3. [al (Synchronization) 


9.3.1. 初始 化 


程序 的 初始 化 在 一 个 独立 的 goroutine 中 执行 。 在 初始 化 过 程 中 创建 的 goroutine 将 在 
第 一 个 用 于 初始 化 goroutine 执 行 完成 后 启动 。 


如 果 包 p 导 和 人 了 包 q， 包 q 的 init 初始 化 函数 将 在 包 p 的 初始 化 之 前 执行 。 
FEF A ERX main.main 则 是 在 所 有 的 init 函数 执行 完成 之 后 启动 。 
在 任意 init 函 数 中 新 创建 的 goroutines， 将 在 所 有 的 init 函数 完成 后 执行 。 


9.3.2. Goroutine 的 创建 
用 于 启动 goroutine 的 go 语句 在 goroutine 之 前 运行 。 
例如 ， 下 面 的 程序 : 


var a string; 


func f() { 
print(a); 
} 


func hello() { 
a = "hello, world"; 
go f(); 


调用 hello 函 数 ， 会 在 某 个 时 刻 打印 “hello, world”( 有 可 能 是 在 hello 函 数 返回 之 
后 ) 。 


9.3.3. Channel communication 管道 通 人 


Dll 


用 管道 通信 是 两 个 goroutines 之 间 同 步 的 主要 方法 。 在 管道 上 执行 的 发 送 操作 会 关 
联 到 该 管道 的 接收 操作 ， 这 通常 对 应 goroutines。 


管道 上 的 发 送 操作 发 生 在 管道 的 接收 完成 之 前 (happens before) 。 
例如 这 个 程序 : 


var c = make(chan int, 10) 
var a string 


func f() { 
a "hello, world"; 
C 0; 


} 


func main() { 


go f(); 
< ee 
print(a); 


可 以 确保 会 输出 "hello, world"。 因 为 ，a 的 赋值 发 生 在 向 管道 发 送 数据 之 前 ， 而 管 
道 的 发 送 操 作 在 管道 接收 完成 之 前 发 生 。 因此 ， 在 print 的 时 候 ，a 已 经 被 赋值 。 


从 一 个 unbuffered 管 道 接收 数据 在 向 管道 发 送 数据 完成 之 前 发 送 。 
下 面 的 是 示例 程序 : 


var c = make(chan int) 
var a string 


func f() { 
a = "hello, world"; 
<-C} 


func main() { 


go f(); 
G <- 0; 
print(a); 


同样 可 以 确保 输出 “hello, world”。 因 为 ，a 的 赋值 在 从 管道 接收 数据 前 发 生 ， 而 从 
管道 接收 数据 操作 在 向 unbuffered 管道 发 送 完 成 之 前 发 生 。 所 以 ， 在 print 的 时 候 ， 
已 经 被 赋值 。 


如 果 用 的 是 缓冲 管道 (如 c= make(chan int, 1) ) ， 将 不 能 保证 输出 “hello， 
world” 结 果 〈 可 能 会 是 空 字 符 串 ， 但 肯定 不 会 是 他 未 知 的 字符 串 ， 或 导致 程序 崩 


省 


o 


9.3.4. 锁 
包 sync 实 现 了 两 种 类 型 的 锁 : sync.Mutex 和 sync.RWMutex. 


对 于 任意 sync.Mutex 或 sync.RWMutex 变量 |。 如 果 n < m ， 那 么 第 n 次 
|.Unlock() 调用 在 第 mX |.Lock() 调用 返回 前 发 生 。 


例如 程序 : 


var 1 sync.Mutex 
var a string 


func f() { 
a = "hello, world"; 
1.Unlock(); 


} 

func main() { 
l.Lock(); 
go f(); 
l.Lock(); 
print(a); 


可 以 确保 输出 “hello, world" 结 果 。 因 为 ， 第 一 次 1.Unlock() HA (Efi) 在 第 
二 次 |.Lock() 调用 (main HAP) 返回 之 前 发 生 ， 也 就 是 在 print 函数 调用 之 前 
发 生 。 


For any call to |.RLock on a sync.RWMutex variable |, there is an n such that the 
|.RLock happens (returns) after the n'th call to |.Unlock and the matching 
|.RUnlock happens before the n+1'th call to |.Lock. 


9.3.5. Once 


包 once 提 供 了 一 个 在 多 个 goroutines 中 进行 初始 化 的 方法 。 多 个 goroutines 可 以 通 
过 once.Do(f) AiG AHR. (Be, WA 只 会 被 执行 一 次 ， 其 他 的 调用 将 被 阻塞 
直到 唯一 执行 的 f() 返 回 。 


once.Do(f) 中 唯一 执行 的 f() 发 生 在 所 有 的 once.Do(f) 返回 之 前 。 
有 代码 : 


var a string 


func setup() { 
a = "hello, world"; 
} 


func doprint() { 
once.Do(setup); 
print(a); 

} 


func twoprint() { 
go doprint(); 
go doprint(); 


调用 twoprint 会 输出 “hello, world” 两 次 。 第 一 次 twoprint HAWS iz {Tsetuplt —— 


“INO 


9.4. 错误 的 同步 方式 


注意 : 变量 读 操作 虽然 可 以 侦 测 到 变量 的 写 操 作 ， 但 是 并 不 能 保证 对 变量 的 读 操作 
就 一 定 发 生 在 写 操作 之 后 。 


例如 : 


Var a, b int 


func f() { 
a =r]; 
b = 2; 

} 

func g() { 
print(b); 
print(a); 

} 

func main() { 
go f(); 
9(); 

} 


函数 g 可 能 输出 2， 也 可 能 输出 0。 
这 种 情形 使 得 我 们 必须 回避 一 些 看 似 合 理 的 用 法 。 
这 里 用 重复 检测 的 方法 来 代替 同步 。 在 例子 中 ，twoprint 范 数 可 能 得 到 错误 的 值 : 


var a string 
var done bool 


func setup() { 
a = "hello, world"; 
done = true; 


} 


func doprint() { 
if !done { 
once.Do(setup) ; 


print(a); 
} 


func twoprint() { 
go doprint(); 
go doprint(); 


在 doprint 落 数 中 ， 写 done 上 暗示 已 经 给 a 赋值 了 。 HERA KAM RE, RARE 
输出 空 的 值 ( 在 2 个 goroutines 中 同时 执行 到 测试 语句 ) 。 


另 一 个 错误 陷阱 是 忙 等 待 : 


var a string 
var done bool 


func setup() { 
a = "hello, world"; 
done = true; 


} 


func main() { 
go setup(); 
for !done { 


print(a); 


我 们 没有 办 法 保证 在 main 中 看 到 了 done 值 被 修改 的 同时 也 能 看 到 a 被 修改 ， 因 此 程 
序 可 能 输出 空 字符 串 。 更 坏 的 结果 是 ，main 函数 可 能 永远 不 知道 done 被 修改 ， 
为 在 两 个 线程 之 间 没 有 同步 操作 ， 这 样 main 函数 永远 不 能 返回 。 


下 面 的 用 法 本 质 上 也 是 同样 的 问题 . 


type T struct { 
msg string; 


} 
var g *T 


func setup() { 
t := new(T); 
t.msg = "hello, world"; 
g=t; 

} 

func main() { 


go setup(); 
for g == nil { 


} 
print(g.msg); 


即使 main 观察 到 了 g != nil 条 件 并 且 退 出 了 循环 ， 但 是 任何 然 不 能 保证 它 看 到 了 
g.msg 的 初始 化 之 后 的 结果 。 


在 这 些 例子 中 ， 只 有 一 种 解决 方法 : 用 显示 的 同步 。 


10. 附录 


10.1. 命令 行 工具 


Name Synopsis 
5a 5a is a version of the Plan 9 assembler. 
5c 5c is a version of the Plan 9 C compiler. 
5g 5g is the version of the gc compiler for the ARM. The : 
51 51 is a modified version of the Plan 9 linker. 
6a 6a is a version of the Plan 9 assembler. 
6c 6c is a version of the Plan 9 C compiler. 
6g 6g is the version of the gc compiler for the x86-64. 
6l 6l is a modified version of the Plan 9 linker. 
8a 8a is a version of the Plan 9 assembler. 
8c 8c is a version of the Plan 9 C compiler. 
8g 8g is the version of the gc compiler for the x86. 
81 8l is a modified version of the Plan 9 linker. 
CC This directory contains the portable section of the Pl: 
cgo Cgo enables the creation of Go packages that call C cc 
COV Cov is a rudimentary code coverage tool. 
ebnflint Ebnflint verifies that EBNF productions are consister 
gc Gc is the generic label for the family of Go compilers 
godefs Godefs is a bootstrapping tool for porting the Go runt: 
godoc Godoc extracts and generates documentation for Go pi 
gofmt Gofmt Go 程序 格式 化 ， 
goinstall Goinstall 尝试 自动 安装 包 的 工具 。 
gomake gomake 是 针对 go 语言 对 GNU make 命 邻 的 简单 包装 。 
gopack Gopack is a variant of the Plan 9 ar tool. 
gotest Gotest is an automated testing tool for Go packages. 
goyacc Goyacc is a version of yacc for Go. 
hgpatch Hgpatch applies a patch to the local Mercurial reposili 
ld This directory contains the portable section of the Plé 
nm Nm is a version of the Plan 9 nm command. 
prof Prof is a rudimentary real-time profiler. 

ad O 人 


10.1.1. 8g 





8g is the version of the gc compiler for the x86. 
The $GOARCH for these tools is 386. 


It reads .go files and outputs .8 files. The flags are documentec 
There is no instruction optimizer, so the -N flag is a no-op. 

8g 是 x86 系 统 的 gc 编译 器 。 

当 $GOARCH 设 置 为 386 时 ， 该 命 售 有效 。 输 入 “.go7 文 件 ， 输 出“ . 87" 文件。 命令 行 选择 ; 
该 版 本 编译 器 没有 进行 指令 优化 ， 因 此 不 支持 ` -N 参数 。 


用 法 : 8g [flags] file.go... 


-I DIR search for packages in DIR 指定 包 的 查找 路 径 
-d print declarations 打印 声明 

-e no limit on number of errors printed 打印 全 部 的 错误 
-f print stack frame structure 打印 栈 帧 结构 

-h panic on an error 过 到 错误 停止 

-0 file specify output file 指定 输出 文件 名 

-S print the assembly language 打印 编译 后 的 汇编 代码 
-V print the compiler version 打印 编译 器 版 本 

-u disable package unsafe 禁用 unsafe 包 

-w print the parse tree after typing 打印 分 析 树 
-x print lex tokens 打印 词法 分 析 结 





10.1.2. 8l 


8l is a modified version of the Plan 9 linker. The original is ( 
81 是 Plan 9 系统 连接 器 的 修改 版 。 文 档 在 : 
http://plan9.bell-labs.com/magic/man2htm1/1/21 


Its target architecture is the x86, referred to by these tools fc 
It reads files in .8 format generated by 8g, 8c, and 8a and emit: 
a binary called 8.out by default. 


输出 的 目标 文件 针对 X86 系统 (由 于 历史 原因 ， 这 些 工具 中 叫 386) 。 
它 的 输入 是 8g， 8c, 和 8a 生 成 的 “.8” 格 式 文件 ， 然 后 默认 输出 8.out 文 件 。 


Major changes include: 
- support for ELF and Mach-0 binary files 
- support for segmented stacks (this feature is implemented | 


重要 的 改动 : 
- 支持 ELF 和 Mach -0 格式 的 二 进 制 文件 
- 支持 分 段 的 栈 (该 特性 不 是 在 编译 器 实现 ， 是 在 这 里 ) 


Original options are listed in the link above. 
原 有 的 选项 在 上 面 提 到 的 文档 中 。 
Options new in this version: 


这 里 是 新 加 选项 : 


Elide the dynamic linking header. With this option, the bine 
is statically linked and does not refer to dynld. Without tl 
(the default), the binary's contents are identical but it is 
-H6 
Write Apple Mach-O binaries (default when $GOOS is darwin) 
生成 Apple Mach -0 格式 文件 ($G00S #darwin) 
-H7 
Write Linux ELF binaries (default when $GOOS is linux) 
生成 Linux 的 ELF 格 式 文件 
“Mdiri p dir2, 0 
Search for libraries (package files) in the comma-separated - 
The default is the single location $GOROOT/pkg/$GOOS_386. 
包 的 目录 列表 ， 以 逗号 分 隔 。 默 认 有 一 个 目录 $GOROO0T/pkg/$600S_386. 
n dirik dir2: T 
Set the dynamic linker search path when using ELF. 
设置 动态 链接 的 查找 路 径 (针对 ELF) 
-V 
Print the linker version. 


输出 连接 器 的 版 本 号 








10.1.3. 8a 


8a is a version of the Plan 9 assembler. The original is documer 
8a 是 Plan 9 的 汇编 器 ， 文 档 在 
http://plan9.bell-labs.com/magic/man2html1/1/2a 
Its target architecture is the x86, referred to by these tools fc 
目标 是 x86 结 构 ， 由 于 历史 原因 ， 这 些 工 具 中 叫 386。 
a] = ee 





10.1.4. gomake 


The gomake command runs GNU make with an appropriate environment 
for using the conventional Go makefiles. If $GOROOT is already 
set in the environment, running gomake is exactly the same 

as running make (or, on BSD systems, running gmake). 


gomake 是 针对 go 语言 对 GNU make 命 令 的 简单 包装 。 
如 果 已 经 设置 了 $GOROOT 环 境 变量 的 话 ，gomake 是 和 gmake 等 价 的 。 如 果 没 有 设置 $6G0 
用 法 : gomake [ Baw... ] 
支持 的 目标 : 
all (默认 ) 
build the package or command, but do not install it. 
构建 全 部 的 包 和 命 舍 ， 但 是 不 进行 安装 操作 。 


install 


build and install the package or command 
构建 全 部 的 包 和 命令 ， 然 后 安装 。 


test 
run the tests (packages only) 
运行 包 的 测试 代码 。 


bench 


run benchmarks (packages only) 
运行 包 的 基准 测试 。 


clean 


remove object files from the current directory 
清空 构建 时 生成 的 临时 文件 。 


nuke 
make clean and remove the installed package or command 
清空 构建 时 生成 的 临时 文件 ， 并 且 删 除 已 经 安装 的 包 和 命令 。 


查看 http://golang.org/doc/code.html 页 面 ， 获 取 关 于 makefiles 的 详细 信 上 
| = = 





10.1.5. cgo 

注 : 该 命 分 有 较 大 更 新 ， 有 些 特性 提供 的 例子 中 没有 展示 。 
Cgo enables the creation of Go packages that call C code. 
coon T+ t\#2 AAE KRAE. 


Usage: cgo [compiler options] file.go 


The compiler options are passed through uninterpreted when 
invoking gcc to compile the C parts of the package. 


编译 器 的 选项 在 调用 gcc 编 译 C 代 码 的 时 候 ， 传 人 gcc。 


The input file.go is a syntactically valid Go source file that ir 
the pseudo-package "C" and then refers to types such as C.size t, 
variables such as C.stdout, or functions such as C.putchar. 


file,go 输 入 文件 是 一 个 导入 了 "C" 虚 拟 包 的 go 源 文 件 。 然 后 可 以 通过 ^C ,7 前 缀 访问 C 
的 内 容 ， 如 C.size_t, C.stdout, C.putchar. 


If the import of "C" is immediately preceded by a comment, that 
comment is used as a header when compiling the C parts of 
the package. For example: 


如 果 注 释 后 紧 跟 着 导入 了 "C" 包 ， 那 么 "C" 之 前 的 注释 将 作为 有 效 的 C 代 码 处 理 。 例 如 : 


// #include <stdio.h> 
// #include <errno.h> 
import "C" 


C identifiers or field names that are keywords in Go can be 
accessed by prefixing them with an underscore: if x points at 
a C struct with a field named "type", x._type accesses the field 


The standard C numeric types are available under the names 
C.char, C.schar (signed char), C.uchar (unsigned char), 

C.short, C.ushort (unsigned short), C.int, C.uint (unsigned int), 
C.long, C.ulong (unsigned long), C.longlong (long long), 
C.ulonglong (unsigned long long), C.float, C.double. 


标准 的 C 数 值 类 型 : 

.char, C.schar (signed char), C.uchar (unsigned char), 

.short, C.ushort (unsigned short), C.int, C.uint (unsigned int), 
.long, C.ulong (unsigned long), C.longlong (long long), 
.Ulonglong (unsigned long long), C.float, C.double. 


OOOO 


To access a struct, union, or enum type directly, prefix it with 
struct_, union_, or enum_, as in C.struct_stat. 


如 果 是 struct，union， 或 enum 类 型 ， 添 加 前 级 struct_，,， union ,or enur 
例如 : C.struct_stat. 


Any C function that returns a value may be called in a multiple 


assignment context to retrieve both the return value and the 
C errno variable as an os.Error. For example: 


任意 有 返回 值 的 C 本 数 ， 可 以 在 go 中 当 作 返 回 多 个 值 处 理 一 第 二 个 返回 值 转 为 os .Erro 
例如 : 


n, err := C.atoi("abc") 


In C, a function argument written as a fixed size array 
actually requires a pointer to the first element of the array. 
C compilers are aware of this calling convention and adjust 
the call accordingly, but Go cannot. In Go, you must pass 
the pointer to the first element explicitly: C.f(&x[0]). 


CHAS, Max PSAE mE ERA BATRE. ECS 
可 以 直接 将 数组 传递 给 函数 参数 ， 但 是 go 不 允许 。go 中 必须 明确 传递 第 一 个 元 素 的 
指针 : C.f(&x[0]). 


Cgo transforms the input file into four output files: two Go soul 
files, a C file for 6c (or 8c or 5c), and aC file for gcc. 


cgo 义 理 后 ， 每 个 输出 的 文件 生成 4 个 输出 文件 : 2 个 是 go 文件 ，1 个 针对 8c/6c 的 C 文 件 ， 
1 个 针对 gcc 的 C 文 件 。 


The standard package makefile rules in Make.pkg automate the 
process of using cgo. See $GOROOT/misc/cgo/stdio and 
$GOROOT/misc/cgo/gmp for examples. 


标准 库 的 makefile 模 板 文 件 Make .pkg 支 持 cgo 语 法 。 例 子 请 参考 : SGOROOT/misc/c 
和 $GOROOT/misc/cgo/gmp。 


Cgo does not yet work with gccgo. 


cgo 目 前 不 支持 gccgo。 





10.1.6. gotest 


Gotest is an automated testing tool for Go packages. 
gotest 是 包 的 自动 测试 工具 。 


Normally a Go package is compiled without its test files. Gotesi 
is a simple script that recompiles the package along with any fi- 
named *_test.go. Functions in the test sources named TestXXX 
(where XXX is any alphanumeric string starting with an upper case 
letter) will be run when the binary is executed. Gotest require: 
that the package have a standard package Makefile, one that 
includes go/src/Make.pkg. 


包 的 测试 文件 默认 是 没有 编译 的 。gotest 是 一 个 用 于 编译 *_test .go 文件 的 脚本 。 
测试 文件 中 所 有 的 TestXXX (XXX 是 大 写字 母 开 头 的 单词 ) 范 数 会 被 执行 。Gotest 
需要 包 的 makefile 文 件 包含 go/src/Make .pkg 模 板 。 


The test functions are run in the order they appear in the source 
They should have signature 


MARRARA IR RIT, Whe FRE: 


func TestXxx(t *testing.T) { ... } 


Benchmark functions can be written as well; they will be run onli 
when the -benchmarks flag is provided. Benchmarks should have 
signature 


基准 测试 也 已 经 支持 ， 只 要 在 命令 行 增加 -benchmarks 选项 。 基 准 测试 函数 的 类 型 : 
func BenchmarkXXX(b *testing.B) { ... } 

See the documentation of the testing package for more informatior 

查看 testing 包 文档 ， 可 以 获取 详细 信息 。 


By default, gotest needs no arguments. It compiles all the .go 1 
in the directory, including tests, and runs the tests. If file r 
are given, only those test files are added to the package. 

(The non-test files are always compiled. ) 


gotest 默 认 不 需要 参数 。 它 编译 目录 中 的 所 有 go 文件 ， 包 含 测 试 文件 ， 然 后 执行 
测试 。 如 果 设 置 文件 名 参数 ， 那 么 只 有 对 应 测试 文件 才 会 被 编译 执行 (无 测试 的 文件 依 甸 


The package is built in a special subdirectory so it does not 
interfere with the non-test installation. 


包 构 建 的 中 间 文 件 默 认 放 在 一 个 特殊 的 子 目录 ， 因 此 不 会 干扰 测试 。 


Usage: 
gotest [pkg_test.go ...] 


The resulting binary, called (for amd64) 6.out, has a couple of 
arguments. 


输出 6.out 文 件 (针对 amd64) 。 有 一 组 命令 行 参数 


Usage: 
6.out [-v] [-match pattern] [-benchmarks pattern] 


The -v flag causes the tests to be logged as they run. The -matc 
flag causes only those tests whose names match the regular expre: 
pattern to be run. By default all tests are run silently. If al: 
the specified test pass, 6.out prints PASS and exits with a 0 ex: 
code. If any tests fail, it prints FAIL and exits with a non-zel 
code. The -benchmarks flag is analogous to the -match flag, but 
applies to benchmarks. No benchmarks run by default. 


选项 -V 执 行 并 记录 全 部 执行 的 测试 。 选 项 -match 只 执行 匹配 的 测试 。 

所 有 测试 默认 没有 输出 。 如 果 全 部 测 斌 通过， 打印 PASS， 返 回 0 后 退出 。 

如 果 有 测试 识别 ， 打 印 FAIL， 返 回 非 需 值 退出 。 选 项 -benchmarks 馈 动 基 准 测试 。 
默认 基准 测试 没有 和 启动 。 











10.1.7. Goyacc 


EJE 


Goyacc is a version of yacc for Go. 
It is written in Go and generates parsers written in Go. 


It is largely transliterated from the Inferno version written in 
which in turn was largely transliterated from the Plan 9 version 
written in C and documented at 


http://plan9.bell-labs.com/magic/man2htm1/1/yacc 
Yacc adepts will have no trouble adapting to this form of the toc 


The file units.y in this directory is a yacc grammar for a versic 
the Unix tool units, also written in Go and largely transliterate 
from the Plan 9 C version. 


The generated parser is reentrant. Parse expects to be given an 
argument that conforms to the following interface: 


type yyLexer interface { 
Lex(lval *yySymType) int 
Error(e string) 


} 


Lex should return the token identifier, and place other token 
information in lval (which replaces the usual yylval). 
Error is equivalent to yyerror in the original yacc. 


Code inside the parser may refer to the variable yylex 
which holds the yyLexer passed to Parse. 





10.1.8. gopack 


Gopack is a variant of the Plan 9 ar tool. The original is docur 
http://plan9.bell-labs.com/magic/man2html/1/ar 


It adds a special Go-specific section __.PKGDEF that collects al: 


Go type information from the files in the archive; that section : 
used by the compiler when importing the package during compilatic 


Usage: gopack [uvnbailo][mrxtdpq] archive files 


The new option 'g' causes gopack to maintain the __.PKGDEF sectic 
as files are added to the archive. 











10.1.9. gofmt 


gofmt 程序 格式 化 ， 


Without an explicit path, it processes the standard input. Given 
it operates on that file; given a directory, it operates on all 
recursively. (Files starting with a period are ignored. ) 


没有 指定 路 径 ， 输 出 到 终端 。 指 定 了 文件 ， 就 操作 当前 文件 。 
指定 了 路 笃 就 递归 指定 路 笃 下 面 的 所 有 .go 文件 。(Files starting with a perio 


Usage: 
gofmt [flags] [path ...] 
选项 : 


-1 

just list files whose formatting differs from gofmt's; generé 
unless -w is also set. 

只 列 出 gofmt 需 要 格式 化 的 文件 ， 不 对 文件 做 任何 操作 ， 除 非 使 用 -w 
-r rule 

apply the rewrite rule to the source before reformatting. 

在 代码 格式 化 之 前 执行 替换 规则 


try to simplify code (after applying the rewrite rule, if an\ 
简化 代码 (在 执行 蔡 换 或 其 他 的 操作 后 ) 


-W 
if set, overwrite each input file with its output. 
如 果 有 -w， 把 格式 化 后 的 代码 写 入 原始 文件 中 
-spaces 
align with spaces instead of tabs. 
使 用 空格 蔡 换 tab 制 表 符 
-tabindent 
indent with tabs independent of -spaces. 
使 用 tab 制 表 符 蔡 换 空格 
-tabwidth=8 
tab width in spaces. 
tab 的 长 度 
调试 选项 : 
-trace 
print parse trace. 
打印 跟踪 分 析 
-ast 


print AST (before rewrites). 
打印 AST (在 重 写 之 前 ) 
-comments=true 
print comments; if false, all comments are elided from the ot 
打印 注释 ， 如 果 是 假 (false)， 所 有 的 注释 信息 不 做 义理 


The rewrite rule specified with the -r flag must be a string of 1 
选项 -fr 的 重 写 规则 必须 遵循 这 个 模式 : 


pattern -> replacement 

Both pattern and replacement must be valid Go expressions. In the 
Single-character lowercase identifiers serve as wildcards matchir 
those expressions will be substituted for the same identifiers ir 
pattern 和 replacement 必 须 是 有 效 的 Go 语法 。Pattern 单字 符 小 宇 标 识 符 作为 通 配 
这 些 表 达 式 将 被 蔡 换 为 相同 的 标识 符 , 

实例 


To check files for unnecessary parentheses: 
检查 并 输出 有 多 余 括号 的 文件 


gofmt -r '(a) -> a' -1 *.go 


To remove the parentheses: 
去 掉 多 余 的 括号 


gofmt -r '(a) -> a' -w *.go 


To convert the package tree from explicit slice upper bounds to : 
slice 使 用 隐形 (implicit ) 替 换 


gofmt -r 'a[B:len(a)] -> a[B:]' -w $GOROOT/src/pkg 
Bugs 


The implementation of -r is a bit slow. 
选项 -r 的 实现 方式 效率 有 些 低 


El = ; 





10.1.10. goinstall 


Goinstall is an experiment in automatic package installation. 
It installs packages, possibly downloading them from the internei 
It maintains a list of public Go packages at http://godashboard.é 


Usage: 
goinstall [flags] importpath... 
goinstall [flags] -a 


Flags and default settings: 


-a=false install all previously installed packac 
-dashboard=true tally public packages on godashboard.appspc 
-log=true log installed packages to $GOROOT/goinstal- 
-u=false update already-downloaded packages 


-v=false verbose operation 


Goinstall installs each of the packages identified on the commanc 
installs a package's prerequisites before trying to install the | 
itself. Unless -log=false is specified, goinstall logs the import 
installed package to $GOROOT/goinstall.log for use by goinstall - 
If the -a flag is given, goinstall reinstalls all previously insi 
packages, reading the list from $GOROOT/goinstall.log. After upc 
new Go release, which deletes all package binaries, running 
goinstall -a 
will recompile and reinstall goinstalled packages. 
Another common idiom is to use 
goinstall -a -u 
to update, recompile, and reinstall all goinstalled packages. 
The source code for a package with import path foo/bar is expecte 
to be in the directory $GOROOT/src/pkg/foo/bar/. If the import 
path refers to a code hosting site, goinstall will download the « 
if necessary. The recognized code hosting sites are: 


BitBucket (Mercurial) 


import "bitbucket.org/user/project" 
import "bitbucket.org/user/project/sub/directory" 


GitHub (Git) 


import "github.com/user/project.git" 
import "github.com/user/project.git/sub/directory" 


Google Code Project Hosting (Mercurial, Subversion) 


import "project.googlecode.com/hg" 
import "project.googlecode.com/hg/sub/directory" 


import "project .googlecode.com/svn/trunk" 
import "project .googlecode.com/svn/trunk/sub/directory" 


Launchpad 
import "launchpad.net/project" 
import "launchpad.net/project/series" 


import "launchpad.net/project/series/sub/directory" 


import "launchpad.net/~user/project/branch" 
import "launchpad.net/~user/project/branch/sub/directory' 


If the destination directory (e.g., $GOROOT/src/pkg/bitbucket . or¢ 
already exists and contains an appropriate checkout, goinstall w: 


attempt to fetch updates. The -u flag changes this behavior, 
Causing goinstall to update all remote packages encountered durir 
the installation. 


When downloading or updating, goinstall first looks for a tag or 
named "release". If there is one, it uses that version of the cc 
Otherwise it uses the default version selected by the version cor 
system, typically HEAD for git, tip for Mercurial. 


After a successful download and installation of a publicly acces: 
remote package, goinstall reports the installation to godashboar< 
which increments a count associated with the package and the time 
of its most recent installation. This mechanism powers the packé 
at http://godashboard.appspot.com/package, allowing Go programme} 
to learn about popular packages that might be worth looking at. 
The -dashboard=false flag disables this reporting. 


By default, goinstall prints output only when it encounters an el 
The -v flag causes goinstall to print information about packages 
being considered and installed. 


Goinstall does not attempt to be a replacement for make. 

Instead, it invokes "make install" after locating the package sot 
For local packages without a Makefile and all remote packages, 
goinstall creates and uses a temporary Makefile constructed from 
the import path and the list of Go files in the package. 


E SSS SSS See 
2011-03-02 





10.2. 视频 和 讲座 


10.2.1. Go Programming 


A presentation delivered by Rob Pike and Russ Cox at Google I/O 2010. It 
illustrates how programming in Go differs from other languages through a set of 
examples demonstrating features particular to Go. These include concurrency, 
embedded types, methods on any type, and program construction using 
interfaces. 


官方 http:/www.youtube.com/watch?v=jgVhBThJdXc 
优酷 : http://v.youku.com/v_show/id_XMTkzOTM40TA4.html 


10.2.2. The Go Tech Talk 


An hour-long talk delivered by Rob Pike at Google in October 2009. The 
language's first public introduction. (See the slides in PDF format.) The language 
has changed since it was made, but it's still a good introduction. 


官方 http:/www.youtube.com/watch?v=rKnDgT73v8s 
优酷 : http://v.youku.com/v_show/id_XMTMxMzlwMTQ4.html] 


10.2.3. gocoding YouTube Channel 


A YouTube channel that includes screencasts and other Go-related videos: 


e Screencast: Writing Go Packages - writing, building, and distributing Go 
packages. 

e Screencast: Testing Go Packages - writing unit tests and benchmarking Go 
packages. 


官方 http://www.youtube.com/gocoding 
10.2.4. The Expressiveness Of Go 
A discussion of the qualities that make Go an expressive and comprehensible 


language. The talk was presented by Rob Pike at JAOO 2010. The recording of 
the event was lost due to a hardware error. 


官方 http://golang.org/doc/ExpressivenessOfGo.pdf 


10.2.5. Another Go at Language Design 


A tour, with some background, of the major features of Go, intended for an 
audience new to the language. The talk was presented at OSCON 2010. See the 
presentation slides. 


This talk was also delivered at Sydney University in September 2010. A video of 
the lecture is available here. 


官方 http:/www.oscon.com/oscon2010/public/schedule/detail/14760 


10.2.6. Go Emerging Languages Conference Talk 


Rob Pike's Emerging Languages Conference presentation delivered in July 2010. 
See the presentation slides. Abstract: 


Go’s approach to concurrency differs from that of many languages, even those 
(such as Erlang) that make concurrency central, yet it has deep roots. The path 
from Hoare’s 1978 paper to Go provides insight into how and why Go works as it 
does. 


官方 http:/Awww.oscon.com/oscon2010/public/schedule/detail/15464 


10.2.7. The Go Promo Video 


A short promotional video featuring Russ Cox demonstrating Go's fast compiler. 
官方 http:/www.youtube.com/watch?v=wwoWei-GAPo 


优酷 : http://v.youku.com/v_show/id_XMTc5MTk3NTY0.html 


10.2.8. The Go Programming Language 


Go is a new, experimental, concurrent, garbage-collected programming language 
developed at Google over the last two years and open sourced in November 
2009. It aims to combine the speed and safety of a static language like C or Java 
with the flexibility and agility of a dynamic language like Python or JavaScript. It is 
intended to serve as a convenient, lightweight, fast language, especially for writing 
concurrent systems such as Web servers and distributed systems. 


This talk will introduce Go's unique feature set, and discuss some of the ways in 
which it is being used today. 


Andrew Gerrand 
Developer Advocate 
Google Sydney 


Andrew Gerrand is a Developer Advocate at Google Sydney where he works on 
the Go Programming Language. He has given presentations and tutorials on Go 
in ten countries across three continents. Before joining Google, he spent 10 years 


programming for ISPs, web start-ups, and freelance clients in Melbourne and 
Sydney. In his spare time he writes code for 30-year-old, 8-bit computers. 


讲义 : http://wh3rd.net/practical-go/ 
官方 http://osdc.blip.tv/file/4432146 
优酷 : http://v.youku.com/v_show/id_XMjl1NzQyMjAw.html 


10.2.9. Go 语言 : 互联 网 时 代 的 C 
国内 的 讲座 。 


优酷 : http:/v.youku.com/v_show/id_XMTY4Mzk5NTc2.html 
2011-03-02 


10.3. Release History 


This page summarizes the changes between tagged releases of Go. For full 
details, see the Mercurial change log. 


10.3.1. 2010-11-23 


This release includes a backwards-incompatible package change to 


sort.Search function (introduced in the last release). 


See the change for details and examples of how you might change \ 
http://code.google.com/p/go/source/detail?r=102866c369 


build: automatically #define _64BIT in 6c. 


o FF FF 


doc: add link to codewalks, 


cgo: print required space after parameter name in wrapper funci 
crypto/cipher: new package to replace crypto/block (thanks Adar 
crypto/elliptic: new package, implements elliptic curves over | 
crypto/x509: policy OID support and fixes (thanks Adam Langley. 


fix recover() documentation (thanks Anschel Schaffer -Cohe 


explain how to write Makefiles for commands. 
* exec: enable more tests on windows (thanks Alex Brainman). 


* gc: adjustable hash code in typecheck of composite literals 
(thanks to vskrap, Andrey Mirtchovski, and Eoghan Sherry: 
* gc: better error message for bad type in channel send (thanks / 


* godoc: bug fix in relativePath, 


compute search index for all file systems under godoc's ( 
use correct time stamp to indicate accuracy of search re: 


index/suffixarray: use sort.Search. 


net: add ReadFrom and WriteTo windows version (thanks Wei Guan¢ 


reflect: remove unnecessary casts in Get methods. 


runtime: free memory allocated by windows CommandLineToArgyv (tI 


* 
* 
* 
* rpc: add RegisterName to allow override of default type name. 
* 
* 
* 


sort: simplify Search (thanks Roger Peppe). 
strings: add LastIndexAny (thanks Benny Siegert). 


ee) 





10.4. Go Roadmap 


This page lists features and ideas being developed or discussed by the Go team. 
This list will be updated as work continues. 


The roadmap should be discussed on the golang-nuts mailing list. 


10.4.1. Language roadmap 


This is a list of language changes that are being considered. Appearance on this 
list is no guarantee that the change will be accepted. 


Possibly rewrite restriction on goto across variable declarations. 

Variant types. A way to define a type as being the union of some set of types. 
Generics. An active topic of discussion. 

Methods for operators, to allow a type to use arithmetic notation for 
expressions. 


10.4.2. Implementation roadmap 


e Improved garbage collector, most likely a reference counting collector with a 
cycle detector running in a separate core. 

Debugger. 

App Engine support. 

Improved CGO including some mechanism for calling back from C to Go. 
Improved implementation documentation. 


10.4.3. Gc compiler roadmap 


Implement goto restrictions. 

Generate DWARF debug info. 

Provide gdb support for runtime facilities. 
Improved optimization. 

5g: Better floating point support. 


10.4.4. Gccgo compiler roadmap 


e Implement goto restrictions. 

e Use goroutines rather than threads. 

e Separate gcc interface from frontend proper. 

e Use escape analysis to keep more data on stack. 


10.4.5. Done 


Safe compilation mode: generate code that is guaranteed not to obtain an 
invalid memory address other than via import "unsafe". 

Gccgo: garbage collection. 

Native Client (NaCl) support. 

SWIG support. 

Simpler semicolon rules. 

A more general definition of ... in parameter lists. 

Explicit conversions from string to []byte and [lint. 

A function that will be run by the garbage collector when an item is freed 
(runtime.SetFinalizer). 

Public continuous build and benchmark infrastructure (gobuilder). 


e Package manager (goinstall). 


A means of recovering from a panic (recover). 


10.5. 相关 资源 
The Go Blog The Go project's official blog, maintained by the core Go developers. 


research!rsc Posts labelled 'Go' by Russ Cox, one of the core Go developers. 


Airs Posts labelled ‘Programming’ by lan Lance Taylor, one of the core Go 
developers. 


nf.id.au Posts labelled 'Go' by Andrew Gerrand, one of the core Go developers 
jmcneil.net Site Perceptive Archive for the 'Go' Category by Jeff McNeil 
mprescient.com Entries in golang by Charles Thompson 
rogpeppe.wordpress.com 

Go Programming Resources 

Golang@Reddit 

Golang@StackOverflow 

Learning Go 


Network programming with Go 


